为 什么 要 与 这 本 书 


移动 互联 网 浪潮 爆发 之 初 ， 关 于 Native App 和 HTML 5 技术 谁 是 未 来 主流 ， 曾 有 一 段 争 议 。 经 过 几 年 的 大 浪 淘 沙 ， 移 动 互联 网 的 入 口 集中 到 少数 几 个 Native App 上 ， 其 中 最 重要 的 入 口 之 一 就 是 微 信 。 大 部 


分 功能 单一 的 App 或 无 人 问津 ， 或 火 过 一 段 时 间 就 销声匿迹 。 相 反 ， 以 HTML 5 技术 为 主 的 轻 应 用 开始 其 露头 角 ， 微 信 公 众 平台 就 是 其 中 之 一 。 据 报道 ， 从 2012 年 8 月 上 线 至 今 ， 微 信 公 众 平台 的 注册 账号 已 
经 突破 200 万 个 ， 并 且 保 持 着 每 天 8000 个 左右 的 增长 速度 。 

出 于 对 微 信 的 关注 ， 微 信 公 众 平台 一 出 现 ， 笔 者 就 开始 接触 ， 并 注册 了 账号 来 运营 和 开发 。 

微 信 公众 平台 越 来 越 重视 健康 生态 的 构建 ， 一 些 商 业 模式 也 开始 慢 慢 明晰 ， 如 自 媒体 、O2O 业 务 、 微 信 支 付 等 。 笔 者 希望 能 将 自己 的 开发 经 验 分 享 给 读者 ， 给 大 家 开发 公众 号 提供 帮助 ， 同 时 也 希望 借 


此 书 来 认识 更 多 对 公众 平台 感 兴趣 的 朋友 。 


读者 对 象 


本 书 的 读者 对 象 包括 : 
` 对 微 信 公众 平台 感 兴趣 的 人 
微 信 公众 账号 运营 者 
. 移动 互联 网 开发 者 
. HTML 5 开发 者 
. 已 有 微 信 开发 经 验 ， 和 希望 深入 了 解 的 人 


: 有 编程 经 验 ， 和 希望 转型 做 微 信 公 众 平台 开发 的 人 


如 何 阅读 本 书 


本 书 在 内 容 逻 辑 上 分 为 3 个 部 分 
第 一 部 分 (第 1 章 ~ 第 3 章 ) 介绍 了 公众 平台 的 基础 知识 、 编 辑 模式 的 使 用 和 开发 环境 的 搭建 。 通 过 本 部 分 的 学 习 ， 读 者 可 以 使 用 编辑 模式 来 运营 公众 账号 ， 并 通过 简单 的 配置 来 搭建 开发 环境 ， 开 发 出 
第 一 个 demo 应 用 ， 为 后 面 的 学 习 打 下 基础 。 
第 二 部 分 (第 4 章 ~ 第 6 章 ) 重点 介绍 公众 平台 的 消息 相关 接口 及 九 大 高 级 接口 ， 并 提供 了 完整 的 封装 类 ， 了 Weixin JS 开发。 读者 在 学 完 本 部 分 之 后 ， 能 够 对 公众 平台 提供 的 全 部 服务 有 所 了 解 。 本 
部 分 提供 了 众多 的 案例 供 读者 学 习 。 
三 部 分 (第 7 章 ~ 第 10 章 ) 以 大 项 目 为 例 ， 每 章 实 现 一 个 公众 号 的 功能 。 四 个 项 目 分 别 为 餐厅 管家 、 微 商城 、 微 酒店 和 游戏 开发 ， 探 讨 的 内 容 包 括 自 定 义 菜单 、 二 维 码 、 微 信 支 付 、 微 信 小 店 、 位 置 服 
人 


务 等 。 学 完 本 部 分 ， 读 者 完全 有 能 力 开 发 企业 级 的 公众 号 。 


勘误 和 支持 


笔者 水 平 有 限 ， 加 之 编写 时 间 仓 促 ， 书 中 难免 会 出 现 一 些 错误 ， 尽 请 读者 批评 指正 。 为 了 更 好 地 与 读者 交流 ， 笔 者 建立 了 一 个 微 社区 ， 读 者 可 以 用 微 信 扫描 以 下 二 维 码 来 访问 ， 或 者 访问 : 


http://wzx.wsq.qq.com/214671676。 


和 


年 








读者 有 任何 问题 可 以 发 送 邮件 至 davidsp@foxmail.com 或 zhoutao908@gmailcom， 笔 者 会 尽快 为 您 解答 。 书 中 的 全 部 源 代 码 可 以 在 华章 网 站 (www.hzbook.com) 下 载 。 


感谢 腾讯 公司 的 微 信 团队 ， 是 他 们 创造 了 这 款 伟大 的 产品 ! 
感谢 北京 天 河 文化 的 王 叶 和 机 械 工业 出 版 社 的 李 华 君 编辑 ， 感 谢 两 位 在 写作 过 程 中 提供 的 帮助 和 支持 ， 正 是 有 你 们 的 鼓励 ， 本 书 才 得 以 顺利 出 版 ! 
感谢 我 的 女友 连 晓 倩 的 支持 、 理 解 与 付出 ， 她 的 鼓励 让 我 能 够 从 零 开 始 写 一 本 书 ! 
说 以 此 书 献 给 我 的 家 人 ， 以 及 微 信 公众 平台 和 所 有 离 不 开 微 信 的 朋友 们 1! 
闫 小 坤 


2014 年 6 月 于 北京 


坐 拥 6 人 Z 注 册 用 户 的 微 信 ， 已 成 为 不 少 人 的 装机 必 备 软件 。 人 们 发 语音 聊天 ， 刷 朋友 圈 ， 读 公众 账号 文章 ， 过 着 离 不 开 微 信 的 日 子 。 对 广大 开发 者 有 利 的 是 ， 这 个 移动 互联 网 上 的 重要 入 口 ， 一 开始 就 以 


开放 姿态 面世 。 微 信 提 供 了 公众 平台 和 开放 平台 ， 分 别 供 公众 账号 运营 者 和 移动 应 用 开发 者 使 用 。 


再 小 的 个 体 ， 也 有 自己 的 品牌 。 无 论 是 企业 、 组 织 ， 还 是 媒体 、 个 人 ， 微 信 公 众 平台 都 可 以 以 轻 应 用 的 形式 提供 服务 。 公 众 平 台 的 编辑 模式 ， 使 不 会 编程 的 用 户 也 能 轻松 使 用 ， 而 开发 模式 和 众多 的 开 
放 接 口 ， 则 为 开发 者 提供 了 广阔 的 想象 空间 和 难得 的 机 遇 。 


本 章 重 点 介绍 一 下 微 信 、 微 信 公 众 平台 及 公众 账号 ， 和 希望 读者 在 投入 微 信 公众 平台 开 友 时 ， 能 对 微 信 公众 平台 能 做 什么 、 鼓 励 做 什么 有 一 定 的 认识 ， 在 开发 过 程 中 少 走 弯路 。 


1.1 微 信 : 连接 一 切 


不 止 一 种 技术 幻想 过 这 样 的 场景 : 快 下 班 时 对 空调 说 “温度 降 到 27 度 ”， 对 热水器 说 “ 烧 热 水 要 洗澡 ”。 企 业 以 智能 家 居 为 物 联 网 技术 的 突破 口 ， 已 经 使 这 样 的 场景 变 为 了 现实 。 微 信和 不光 连接 人 ， 还 
可 以 连接 能 上 网 的 机 器 。 每 个 机 器 都 有 个 二 维 码 作为 设备 ID， 在 微 信里 可 以 通过 和 设备 对 话 来 控制 设备 。 微 信 作 为 连接 者 ， 成 为 最 有 价值 的 用 户 与 用 户 最 满意 的 产品 之 间 的 桥梁 。 


1.1.1 物 联网 


微 信 有 两 大 逆 天 功能 : 摇 一 摇 和 扫 一 扫 。 前 者 曾 创造 了 “点 亮 广州 塔 ”的 辉煌 事迹 ， 后 者 则 培养 了 用 户 见 黑白 方块 就 扫 的 习惯 。 见 到 下 面 印 有 二 维 码 的 奶牛 ， 读 者 是 不 是 有 扫 一 扫 的 冲动 呢 ? 
真 的 能 扫 ! 你 会 发 现 打开 了 网 页 ， 上 面 这 样 介绍 这 头 奶牛 : 

名 字 : Shamrock 

品种 : 黑白 人 花 乳 牛 

每 天 产 30~40 升 牛奶 。 

夏天 到 野外 吃 新 鲜 青 草 ， 冬 天 青草 不 再 生长 时 ， 改 吃 青贮 饲料 。 

需要 平衡 的 饮食 。 


时 常 有 农业 科学 家 来 和 农场 主 讨论 青贮 饲料 和 谷物 的 比例 ， 并 制定 一 系列 计划 来 保证 它 的 健康 。 










这 是 一 篇 来 自 BBC 的 报道 ， 农 场 主 给 奶牛 身上 涂 上 二 维 码 来 宣传 牧场 。 只 要 扫 一 下 牛 身上 的 二 维 码 ， 即 可 知道 这 头 奶牛 的 所 有 资料 。 
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奶牛 二 维 码 的 内 容 是 一 个 短 链接 : http://goo.gl/yAE1Q， 完 整 URL 为 http://www .thisisdairy farming.com/news-press/in-the-news/lady-shamrock/ 不 能 扫 一 扫 的 读者 ， 可 以 访问 此 链接 。 


这 在 技术 上 并 不 神奇 ， 生 成 二 维 码 ， 扫 描 二 维 码 ， 都 是 业界 成 熟 的 技术 。 但 利用 微 信 “ 扫 一 扫 ” 连 接 奶 牛 (物理 世界 ) 和 互联 网 (信息 世界 ) ， 或 者 用 微 信 控 制 家 用 电器 ， 这 种 人 与 物 、 物 与 物 之 间 的 
连接 ， 正 是 物 联网 的 基础 。 


1.1.2 ”二 维 码 革命 


奶牛 身上 印 有 二 维 码 ， 扫 描 后 显示 链接 (文字 ) ， 再 跳 转 到 相应 的 网 页 。 这 说 明 二 维 码 是 一 种 编码 方式 。 这 里 介绍 一 下 二 维 码 及 其 前 景 。 


二 维 码 英 文 为 Quick Response Code， 简 写 为 QR code。 通 俗 地 讲 ， 二 维 码 是 二 维 的 条 形 码 ， 可 以 在 水 平和 竖 直 方向 同时 存储 信息 。 生 成 的 二 维 码 图 形 一 般 为 正方 形 ， 根 据 特定 的 编码 方式 ， 在 平面 
(二 维 方向 ) 上 绘制 黑白 相间 的 图 形 。 例 如 微 信 公众 平台 的 二 维 码 如 下 : 





从 条 形 码 到 二 维 码 


大 家 是 否 见 过 下 图 的 两 张 火车 样 票 ? 


我 相信 大 多 数 读者 都 见 过 右边 的 蓝 票 ， 左 边 的 红 票 可 能 没 见 过 。 这 里 简单 介绍 一 下 : 红 票 为 软 纸 票 ， 是 1997 年 确定 的 车 票 统一 式样 。2009 年 12 月 ， 铁 路 部 门 对 火车 票 进行 升级 改版 ,并 在 2010 年 春运 


前 推出 磁卡 票 ( 蓝 票 ) 。 


蓝 票 与 红 票 最 明显 的 变化 是 车 票 下 方 的 条 形 码 变 成 二 维 码 。 


Pr 
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图 1-2 
2. 为 什么 二 维 码 是 一 场 革命 
人 类 社会 的 信息 革命 ， 常 常 伴随 着 一 种 新 的 编码 方式 而 出 现 。 
1836 年 萨 缪 尔 . 摩 尔 斯 发 明了 摩尔 斯 电码 (Morse Code) ， 它 是 一 种 时 断 时 续 的 信号 ， 由 点 、 划 、 停 顿 长 短 等 作为 基本 单位 ， 通 过 不 同 的 排列 顺序 来 编码 不 同 的 文字 符号 。 这 项 技术 使 得 通信 距离 大 大 


增加 ， 而 信息 几乎 瞬时 到 达 。 后 来 摩尔 斯 电码 被 用 于 电报 业务 ， 并 且 被 作为 海事 通信 的 国际 标准 一 直 使 用 到 1999 年 。 


诺 曙 :约瑟夫 :伍德 兰 在 1952 年 注册 了 条 形 码 专利 。22 年 后 的 1974 年 ， 俄 雍 俄 州 一 家 超级 市 场 的 口香糖 成 为 首 个 扫描 条 形 码 的 商品 。 这 项 技术 使 得 输入 效率 和 准确 率 大 幅 提 升 。 现 在 ,条形码 广泛 用 于 各 
个 领域 和 行业 ， 如 零售 业 、 书 籍 、 服 装 、 商 品 、 银 行 、 医 疗 及 电子 产品 等 。 


QR 二 维 码 由 日 本 丰田 子 公司 Denso Wave 于 1994 年 发 明 并 开始 使 用 。 微 信 的 “ 扫 一 扫 ” 功 能 ， 使 得 二 维 码 的 作用 发 挥 到 极致 。 墙 壁 、 门 窗 、 纸 张 上 印刷 的 二 维 码 ， 扫 一 下 就 能 打开 网 页 、 调 用 App、 完 
成 校 验 、 购 买 物品 、 支 付费 用 ， 瞬 间 完 成 从 线 下 到 线 上 的 转变 。 而 微 信 公众 平台 提供 的 生成 带 参 数 的 二 维 码 功能 ， 可 以 为 线 上 的 URL 连 接 、 商 品 、 支 付 信息 生成 二 维 码 ， 该 二 维 码 可 以 被 查看 、 下 载 、 印 
刷 ， 完 成 线 上 到 线 下 的 转变 。 


二 维 码 的 信息 容量 大 ， 能 够 编码 数字 、 字 母 、 汉 字 、 图 片 等 信息 。 拿 纠 错 级 别 L 的 Version 40 二 维 码 来 说 ， 能 够 容纳 2953 字 节 ， 或 1817 个 utf8 编 码 的 中 文字 符 。 这 个 容量 级 别 ， 能 够 放下 个 人 名 片 、 电 
子 票务 赁 证、 优惠 券 、 电 子 回执 等 ， 能 够 适应 于 各 行 各 业 的 应 用 。 


在 移动 互联 网 时 代 ， 手 机 就 是 一 个 天 然 的 二 维 码 扫描 器 ， 随 着 手机 的 普及 和 移动 网 络 的 发 展 ， 未 来 肯定 会 出 现 更 多 二 维 码 相关 的 产品 ， 二 维 码 也 终 将 影响 到 各 个 行业 。 


微 信 有 两 大 公众 平台 分 别 为 : 开放 平台 和 公众 平台 。 
“ 开放 平台 。 针 对 移动 应 用 开发 。 开 发 者 接 入 微 信 开放 平台 后 ， 可 以 使 移动 应 用 支持 微 信 分 享 、 微 信 收 藏 和 微 信 支付 。 官 方 网 站 为 : https://open.weixin.qq.com。 


“ 公众 平台 。 接 入 微 信 开 放 平 台 公 众 账 号 开发 ， 提 供 类 似 于 轻 应 用 的 服务 。https://mp.weixin.qq.com。 本 书 主要 关注 公众 平台 账号 开发 。 


1.2.1 _ 大事记 


1) 2012 年 8 月 17 日 ， 公 众 平台 面向 普通 用 户 开放 注册 。 

2) 2013 年 3 月 19 日 ， 公 众 平台 开放 “ 自 定 义 菜单 ”内 测 资格 申请 。 

3) 2013 年 8 月 5 日 ， 公 众 平台 将 公众 号 细 分 为 服务 号 和 订阅 号 。 服 务 号 每 月 只 能 群发 一 条 消息 ; 订阅 号 每 天 可 发 一 条 ， 但 消息 被 折 翅 到 订阅 者 分 类 中 。 
4) 2013 年 8 月 29 日 ， 公 众 平 台 增 加 数据 统计 功能 。 

5) 2013 年 10 月 29 日 ， 公 众 平 台新 版 公测 ， 主 要 开放 高 级 接口 。 

6) 2013 年 12 月 ， 公 众 平 台 发 布 了 一 系列 公告 ， 打 击 违 法 违规 的 内 容 和 行为 ， 主 要 包括 以 下 内 容 : 

. 打击 假冒 伪劣 商品 销售 推广 行为 。 


* 打击 诱导 分 享 行为 。 反 对 不 正当 利用 公众 号 群发 消息 的 功能 破坏 用 户 体验 的 行为 ， 特 别 是 通过 群发 消息 等 手段 强制 或 诱导 用 户 分 享 至 朋友 圈 的 营销 行为 是 我 们 所 不 鼓励 的 (例如 通过 奖励 诱 使 用 户 进 
行 分 享 、 强 制 要 求 分 享 至 朋友 圈 即 可 查看 等 行为 ) 。 


7) 2014 年 3 月 5 日 ， 公 众 平台 发 布 微 信 支 付 申请 指引 ， 标 志 着 微 信 支 付 正 式 对 服务 号 开放 。 
8) 2014 年 4 月 4 日 ， 公 众 平台 发 布 《 微 信 公 众 平台 运营 规范 》， 明 文 规定 平台 反对 和 禁止 的 行为 及 处 罚 机 制 与 举报 机 制 。 


9) 2014 年 4 月 15 日 ， 公 众 平台 进行 服务 号 群发 策略 调整 。 所 有 服务 号 的 群发 次 数 由 原来 的 每 月 1 次 改 为 每 月 (自然 月 ) 4 次 。 此 外 对 已 微 信 认 证 的 服务 号 ， 开 放 公众 平台 高 级 群发 接口 ， 开 发 者 可 以 通过 
高 级 群发 接口 实现 更 灵活 的 群发 。 


10) 2014 年 5 月 6 日 ， 腾 讯 公司 宣布 成 立 微 信 事 业 群 (WeiXin Group， 简 称 WXG) ， 腾 讯 公司 高 级 执行 副 总 裁 张 小 龙 出 任 微 信和 事业 群 总 裁 。 这 意味 着 微 信 的 发 展 进入 一 个 轩 新 的 阶段 。 


11) 2014 年 5 月 9 日 ， 公 众 平台 新 增 投票 和 多 客服 功能 。 


12) 2014 年 5 月 22 日 ， 微 信 认 证 结果 拆 分 为 资质 审核 和 名 称 审核 。 
13) 2014 年 5 月 29 日 ， 公 众 平台 增加 微 信 小 店 功能 ， 已 接 入 微 信 支付 的 服务 号 ， 可 以 申请 开通 微 信 小 店 功能 。 


14) 2014 年 6 月 6 日 ， 公 众 平台 发 布 清理 “ 集 赞 ”行为 的 公告 ， 对 利用 朋友 圈 “ 集 赞 ”的 行为 进行 打击 。 处 罚 力 度 很 大 ， 公 众 号 累计 发 现 四 次 有 “ 集 赞 ”行为 ， 永 久 封号 ， 不 可 解 封 。 


1.2.2 分 类 : 服务 号 与 订阅 号 


公众 账号 分 为 两 种 : 服务 号 和 订阅 号 。 这 两 种 账号 的 应 用 范围 和 所 能 获得 的 服务 各 不 相同 。 服 务 号 给 企业 和 组 织 提供 更 强大 的 业务 服务 与 用 户 管理 能 力 ， 帮 助 企业 快速 实现 全 新 的 公众 号 服务 平台 。 对 
于 企业 和 组 织 ， 可 选用 服务 号 。 订 阅 号 为 媒体 和 个 人 提供 一 种 新 的 信息 传播 方式 ， 构 建 与 读者 之 间 更 好 的 沟通 与 管理 模式 。 对 于 媒体 和 个 人 ， 可 选用 订阅 号 。 





服务 号 的 功能 如 下 : 
权限 | 摘 述 
语音 识 别 通过 语音 识别 接 0， 用 户 友 送 的 语音 ,将 会 同时 给 出 语音 识别 出 的 文本 内 容 。 
客服 接口 通过 客服 接口 ,公认 与 可 以 在 用 尸 友 送 过 消息 的 24 小 时 内 ， 向 用 户 回 复 背 宕 
OAuth2.0 网 页 授权 通过 网 外 授权 接口 ， 公众 与 可 以 请 求 用 户 授 权 。 


通过 该 接口 ， 公 你 号 可 以 获得 一 系 列 携 惠 不 同 参 数 的 二 维 俏 ， 在 用 户 扫 撞 关 注 公 众 号 后 


公众 号 可 以 根据 参数 分 析 各 二 维 码 的 效果 . 


获取 用 户 地 理 位 音 通过 该 接口 ， 公众 与 能 够 获得 用 户 进 入 公众 写 会 话 时 的 地 理 位 是 ( 需要 用 户 同 意 ) 。 


过 该 接口 ， 公 众 号 可 以 根据 加 密 后 和 的 用 户 OpenID ， 获取 用 户 的 基础 信息 ， 包括 头像 . 


获取 用 户 基本 信息 
和 e 和 名称、 性 别 、 地 区 。 


获取 关注 者 列表 通过 谈 接 0D ,公众 三 可 以 获 职 所 有 关注 者 的 OpenlID， 
用 户 分 组 接口 站 ， 全 让 三 可 以 在 后 台 为 用 户 移动 分 组 ， 或 创建 、 修 改 分 组 。 





上 传 下载 多 巡 体 文件 通过 该 接口 ， 公 人 承 瑟 可 以 在 毅 委 时 在 柚 信 服务 本 上 传 卡 载 多 媒体 驻 件 。 


订阅 号 的 功能 较 少 ， 没 通过 认证 前 只 有 消息 接口 。 通 过 认证 后 会 增加 自 定义 菜单 功能 。 





接收 用 户 消息 
基础 接口 向 用 户 回复 消息 有 效 








1.2.3 ” 微 信 认证 
微 信 的 审核 和 认证 流程 很 严格 ， 因 此 读者 在 申请 认证 前 ， 务 必要 谨慎 对 待 ， 这 里 列 出 一 些 需要 注意 的 地 方 。 


1. 名 称 不 易 修 改 


微 信 公众 号 的 名 称 一 旦 设 定 ， 不 易 修 改 。 如 果 需 要 修改 ， 可 以 发 邮件 给 微 信 公 众 平台 官方 (weixinmp@qq.com) 。 


2. 关 联 微 博 认 证 


目前 提供 腾讯 微 博 认证 。 如 果 你 已 经 获得 腾讯 微 博 认 证 ， 可 以 在 “设置 ”页 的 账号 信息 下 ， 申 请 认证 。 微 博 认证 失败 最 常见 的 情况 是 微 信 名 称 和 微 博 名 称 不 一 致 。 这 时 ， 除 了 改 徽 信 名 称 或 微 博 名 称 
外 ， 可 以 申请 人 工 审核 。 其 方法 仍 是 向 微 信 公众 平台 官方 发 送 邮件 进行 申请 。 针 对 此 类 申请 的 基本 要 求 包括 : 


1) 你 的 微 博 认证 资料 能 证 明 你 是 某 领域 专业 人 士 。 
2) 你 的 公众 号 应 明确 属于 该 领域 。 
3) 需要 你 提供 以 下 材料 : 
“ 提供 微 信 认 证 过 程 截图 
. 微 信 公众 号 昵称 、ID、 公 众 号 内 容 说 明 
“ 认证 微 博 的 地 址 
. 认证 过 程 分 享 二 维 码 的 微 博 地 址 及 分 享 的 二 维 码 截图 
微 信 公 众 平 台 在 7 个 工作 日 内 会 通过 邮件 给 出 审核 结果 。 
3. 微 信 认 证 
2014 年 5 月 22 日 ， 公 众 平台 发 布 公告 ， 微 信 认 证 结果 拆 分 为 资质 审核 和 名 称 审核 。 从 当天 起 ， 微 信 认 证 结果 将 分 为 账号 主体 资质 审核 和 账号 名 称 审核 。 
1) 代表 企业 资料 真实 性 的 账号 主体 资质 ， 审 核 成 功 后 ， 订 阅 号 可 立即 获得 自 定 义 菜单 ， 服 务 号 可 立即 获得 公众 平台 所 有 高 级 接口 和 功能 。 


2) 代表 企业 标识 的 账号 名 称 ， 审 核 成 功 后 ， 订 阅 号 和 服务 号 均 可 获得 认证 的 “ 勾 ” 和 相关 信息 备注 。 





以 上 策略 更 新 后 ， 操 作 上 没有 任何 变化 ， 但 整个 认证 流程 会 分 成 两 个 阶段 的 结果 通知 到 运营 者 。 对 公众 号 最 大 的 好 处 是 : 只 要 账号 主体 资质 审核 通过 ， 就 会 获得 所 有 高 级 接口 和 功能 一 一 订阅 号 获得 自 
定义 菜单 ， 服 务 号 获得 开放 的 所 有 高 级 接口 。 通 俗 地 说 ， 假 设 我 有 一 个 公众 号 叫 免 子 ， 但 其 实 “兔子 ”是 兔子 饭庄 。 这 样 在 认证 的 时 候 ， 名 称 审核 肯定 不 能 通过 ， 因 为 “兔子 ”是 一 个 通用 词 ， 不 可 能 认证 
为 一 个 饭店 的 名 称 。 但 你 的 主体 资质 是 饭店 ， 主 体 资质 就 能 通过 ， 就 能 获得 自 定义 菜单 和 所 有 高 级 接口 。 著 名 的 自 媒体 人 青龙 老 贼 对 《 微 信 认 证 规则 调整 办 法 》 有 一 个 通俗 版 解读 ， 有 兴趣 的 读者 请 参考 : 
http://url.cn/QXheG1, 


1.2.4 ”公众 号 运 莒 

2014 年 4 月 4 日 ， 公 众 平台 发 布 《 微 信 公 众 平台 运营 规范 》， 为 建设 绿色 、 健 康 的 微 信 生 态 环境 ， 做 到 了 “有 法 可 依 ”。 对 于 “执法 必 严 ， 违 法 必 究 。， 对 于 诱导 用 户 分 享 到 朋友 圈 、“ 集 赞 ”等 行为 ， 
处 罚 相当 严重 。 对 于 公众 号 运营 者 来 说 ， 运 营 活 动 不 仪 要 给 用 户 带 来 真正 有 价值 的 信息 和 服务 ， 而 且 要 遵守 规范 ， 不 要 和 触 碰 底 线 。 这 里 和 读者 分 享 几 点 提示 。 

1) 不 要 骚扰 用 户 。 无 论 服务 号 还 是 订阅 号 ， 用 户 的 关注 与 取消 关注 都 十 分 便捷 ， 因 此 不 要 过 度 营销 ， 不 要 骚扰 用 户 。 


2) 不 要 乱 碰 朋 友 圈 。 微 信 的 朋友 圈 是 一 个 由 熟人 关系 链 构 建 而 成 的 小 众 、 私 密 的 圈子 ， 用 户 在 朋友 圈 中 分 享 和 关注 朋友 们 的 生活 点 滴 ， 从 而 加 强人 们 之 间 的 联系 ， 它 并 不 是 一 个 营销 平台 。 简 言 之 ， 朋 
友 圈 和 公众 平台 是 微 信 的 两 个 独立 产品 ， 其 定位 和 功能 不 同 。 朋 友 圈 是 院子 ， 公 众 平台 是 广场 。 把 广场 的 东西 堆 满 院 子 ， 是 谁 都 不 想 看 到 的 。 当 然 ， 用 户 自愿 分 享 优质 内 容 ， 不 在 此 列 。 


3) 不 要 使 用 外 挂 。 揪 件 、 外 挂 等 大 多 使 用 模拟 登录 方式 ， 而 非 公众 平台 开放 的 接口 。 使 用 外 挂 来 规避 群发 限制 策略 ， 用 公众 平台 的 单 发 功能 来 实现 群发 功能 ， 意 图 规避 公众 平台 对 于 群发 次 数 的 限制 
， 这 些 都 是 不 可 取 的 。 


由 


4) 重视 线 下 的 推广 。 微 信 担 负 着 O2O 业 务 的 重任 ， 所 以 鼓励 开发 者 进行 02O 相 关 产 品 的 开发 。 例 如 一 栋 大 楼 的 二 维 码 ， 扫 摘 关 注 后 ， 能 看 到 大 楼 的 概况 、 楼 层 配置 、 物 业 情 况 、 写 字 楼 租赁 信息 ， 甚 
至 能 知道 电梯 停靠 在 几 层 ; 或 者 商店 在 店面 放置 二 维 码 来 推广 ， 用 户 在 微 信 上 就 可 完成 下 单 和 支付 。 


1.2.5 微 社区 


相信 读者 都 见 过 这 样 的 公众 号 ， 自 定义 菜单 加 上 社区 链接 ， 全 然 一 个 手机 App 的 样子 。 图 1-5 是 “大 象 公社 ”的 自 定 义 菜单 截图 ， 其 中 的 大 象 社区 是 微 社区 。 
一 一 | 
国 国 国 国 加 
es 文 草 有 目录 大 象 仁 区 


提 到 社区 论坛 ， 读 者 也 许 会 想到 Discuz! 。Discuz! 是 全 球 安装 量 最 大 的 论坛 软件 系统 。“ 老 树 开 新 化 ”， 在 移动 互联 网 时 代 ，Discuz! 团队 开发 了 手机 上 的 新 社区 : “ 微 社区 ”。 


微 社区 是 基于 微 信 公 众 账 号 的 互动 社区 ， 其 官网 地 址 为 : http://wsq.99q.com。 它 可 以 广泛 应 用 于 微 信服 务 号 与 订阅 号 ， 微 信 公 众 号 的 粉丝 们 可 以 在 微 社区 里 自由 交流 ， 发 帖 、 回 帖 、 上 传 照片 等 ， 是 
微 信 公 众 号 运营 者 打造 人 气 移动 社区 、 增 强 用 户 黏 性 的 有 利 工具 。 


如 果 说 微 信 公 众 平台 提供 了 “一 对 多 ”的 单 向 消息 流 ， 那 么 微 社区 无 疑 是 “多 对 多 ”的 沟通 模式 。 用 户 与 用 户 、 用 户 与 运营 者 之 间 可 以 双向 交流 ， 给 用 户 带 来 更 好 的 互动 体验 ， 让 互动 更 便捷 、 更 畅 


微 社 区 具有 以 下 优点 : 
轻 量 级 。 不 需要 客户 端 ， 在 微 信 的 公众 账号 、 手 机 QQ 和 手机 Qzone 里 即 可 访问 。 


与 PC 端 论坛 打通 。 一 些 站 长 运营 着 PC 端 论坛 ， 微 社区 官方 有 计划 跟 PC 端 论坛 的 数据 打通 ， 这 样 即 可 利用 原来 社区 的 内 容 ， 又 可 吸引 原来 社区 的 用 户 。 


“ 获取 用 户 的 成 本 降低 。 
. 与 公众 账号 的 推送 能 力 相 结合 ， 增 加 用 户 回流 和 活跃 度 。 
那么 如 何 运营 好 微 社区 呢 ? 
. 第 一 ， 定 位 要 清晰 。 微 社区 官方 希望 推荐 给 用 户 一 些 重 直 化 、 本 地 化 的 信息 ， 更 好 地 满足 用 户 个 性 化 的 需求 。 比 如 根据 用 户 的 兴趣 或 用 户 的 所 在 地 ， 推 荐 用 户 比较 感 兴趣 、 与 之 相关 联 的 信息 。 
“ 第 二 ， 要 有 优质 内 容 。 能 够 吸引 用 户 ， 并 且 使 其 有 分 享 和 传播 的 和 欲望。 


第 三 ， 合 理 利 用 社交 关系 来 引流 。 我 们 可 以 利用 朋友 圈 、QQ 群 、 微 信 好 友和 QQ 好 友 等 社交 关系 来 吸引 流量 。 


1.2.6 ” 微 信 公众 平台 管理 后 台 








s 微 信 公 庆 平台 关于 清理 集 丑 行为 的 公告 下 2014-06-06 
公 全 平台 增加 微 信 小 店 功能 ， 可 快速 开店 加 2014-05-29 
短信 认证 壬 宗 拆 分 为 资质 审 校 相 名 称 审 校 2014-05-22 

“ 微 信 公开 课 ” 第 一 季 精 彩 视频 上 线 四 2014-05-22 
公众 平台 安全 中 心 改版 ， 并 增加 安全 提醒 功能 2014-05-20 
公众 平台 新 增 投票 和 多 容 服 功能 2014-05-09 
开发 接口 access_ token 长 度 修 改 通 知 2014-04-25 


s 服务 三 群 点 策略 调整 2014-04-15 


s 《《 徽 信 公众 平台 运营 规范 》 点 布 2014-04-04 


s 移动 应 用 微 信 支 付 申请 指引 2014-03-19 


9 公众 写 微 信 支 付 申 请 指引 2014-03-05 





图 1-6 
左 侧 是 导航 菜单 ， 分 为 功能 、 管 理 、 服 务 、 统 计 、 设 置 五 个 部 分 。 右 上 显示 新 消息 、 新 增 人 数 和 总 用 户 数 。 右 下 显示 系统 公告 、 公 众 平台 发 布 的 公告 和 更 新 说 明 。 


功能 包括 群发 功能 和 高 级 功能 。 群 发 功能 可 以 将 文字 、 语 音 、 图 片 、 视 频 、 图 文 消息 等 类 型 的 内 容 ， 下 发 给 粉丝 ， 而 且 人 数 不 限 。 群 发 消息 的 到 达 率 和 阅读 量 都 远 高 于 其 他 渠道 ， 而 且 作者 能 够 自由 控 
制 推送 的 时 间 ， 能 够 接受 读者 的 反馈 ， 所 以 这 个 功能 一 开始 就 得 到 了 广大 媒体 用 户 的 欢迎 ，“ 自 媒体 ”概念 也 随 之 产生 和 流行 。 高 级 功能 包括 编辑 模式 和 开发 模式 。 编 辑 模式 的 使 用 将 在 第 2 章 探讨 ， 而 开发 
模式 正 是 本 书 的 重点 ， 将 在 第 3 章 及 后 续 章节 中 详细 说 明 。 


管理 分 为 消息 管理 、 用 户 管理 和 素材 管理 。 在 消息 管理 中 ， 可 以 查看 最 近 5 天 的 消息 ， 并 能 回复 用 户 。 用 户 管理 显示 用 户 列 表 ， 能 够 对 用 户 进行 分 组 、 修 改 备注 名 、 拉 黑 名 单 等 操作 。 素 材 管理 可 以 上 传 
图 片 、 语 音 、 视 频 ， 并 可 以 编辑 图 文 消息 。 


服务 分 为 服务 中 心 和 我 的 服务 。 服 务 中 心 显 示 所 有 可 申请 的 服务 ， 而 我 的 服务 显示 我 已 经 获得 的 服务 。 


统计 功能 分 为 用 户 分 析 、 图 文 分 析 、 消 息 分 析 和 接口 分 析 。 其 中 用 户 分 析 可 以 查看 用 户 增 长 情况 和 用 户 属 性 ; 图 文 分 析 可 以 查看 群发 图 文 消息 的 效果 ， 包 括 送 达 人 数 、 图 文 页 阅读 人 数 、 原 文 页 阅读 人 
数 和 分 享 转发 人 数 ; 消息 分 析 可 以 查看 用 户 发 送 的 消息 的 统计 情况 ; 接口 分 析 则 能 查看 接口 的 调用 次 数 、 失 败 率 、 平 均 耗 时 和 最 大 耗 时 等 统计 情况 ， 供 开发 者 根据 数据 改善 程序 。 


设置 分 为 账号 信息 、 公 众 号 安全 助手 和 安全 中 心 。 账 号 信息 页 可 以 修改 头像 、 登 录 邮 箱 和 功能 介绍 ， 但 一 个 月 内 只 能 申请 修改 一 次 ; 可 以 绑 定 腾 讯 微 博 和 设置 图 片 水 印 ， 另 外 还 有 关联 微 博 认证 和 微 信 
认证 的 入 口 。 公 众 号 安全 助手 可 以 绑 定 个 人 微 信号 ， 比 定 后 能 够 通过 微 信号 进行 群发 ， 并 通过 设置 安全 微 信 保护 来 保证 公众 账号 的 安全 。 安 全 中 心 用 来 设置 公众 号 安全 助手 的 安全 保护 和 安全 提醒 功能 。 


1.3” 本章 小 结 


本 章 首先 介绍 了 微 信 的 愿景 ， 连 接 一 切 ， 包 括 “ 连 接 人 ， 连 接 企业 ， 连 接 物 体 ”。 微 信 本 身 连 接 人 与 人 ， 物 联网 连接 物 与 物 ， 二 维 码 连接 人 与 物 。 三 者 结合 形成 “有 机 的 自 运转 的 系统 ”。 微 信 公 众 平 


台 正 是 微 信 开 放 系 统 的 一 部 分 。 本 章 还 介绍 了 公众 平台 的 发 展 历程 和 基本 知识 、 运 营 需 注意 的 问题 ， 并 简单 介绍 了 管理 后 台 的 使 用 。 通 过 本 章 的 学 习 ， 和 希望 读者 能 发 现 符合 “连接 ”的 产品 和 方向 ， 加 入 到 


微 信 公 众 号 开发 者 的 行列 中 。 


第 2 和 章 ”编辑 模式 一 一 轻松 玩 转 公 众 号 


微 信 公众 平台 的 核心 是 与 用 户 的 互动 ， 在 互动 中 为 用 户 提 供 服务 ， 在 服务 中 产生 价值 ， 微 信 运 营 理念 也 提倡 通过 人 工 回复 与 用 户 进行 沟通 。 通 过 上 一 章 的 学 习 ， 相 信 读 者 已 经 掌握 如 何 通 过 微 信 
管理 后 台 与 用 户 进行 互动 。 但 实际 中 也 存在 很 多 根据 关键 词 提取 固定 信息 回复 的 场景 ， 比 如 对 刚 关 注 用 户 发 送 一 条 消息 ， 又 如 针对 用 户 询问 发 送 某 件 商 品 的 详细 信息 ， 


低 ， 也 不 能 满足 对 用 户 实时 回复 的 要 求 ， 降 低 了 用 户 体 验 。 微 信 公 众 平台 通过 开发 模式 和 编辑 模式 为 公众 号 运营 者 提供 了 强大 的 工具 ， 其 中 编辑 模式 主要 针对 没有 开发 能 力 的 公众 号 


你 走 进 编辑 模式 。 


2.1 ”开启 编辑 模式 


依次 点 击 公 众 平台 管理 后 台 的 “功能 ”一 “高 级 功能 ”， 进 入 图 2-1 所 示 界 面 。 微 信 公 众 平台 管理 后 台 


6 ( 只 可 局 用 一 种 模式 ) 


在 此 模式 下 ， 可 以 通过 简单 的 界面 编辑 ， 
来 设置 自动 回复 。 ee 也 皇 底部 
自 定义 菜单 等 功能 , 


《3》 已 关闭 


图 


提供 了 两 种 模式 : 编辑 模式 和 开发 模式 。 


开 友 模式 


在 此 模 翅 下 ， 开 发 者 oJL 有 是 过 2 公 俯 平 全 要 
供 的 接口 ， 记 现 目 动 回复 ，、 鞭 取 订 疯 者 、 
目 定义 菜单 等 功能 ，。 


全 已 关闭 





两 种 模式 互 斥 ， 不 能 同时 开启 ， 默 认 情 况 下 都 是 关闭 状态 。 这 章 我 们 介绍 编辑 模式 ， 上 点击“ 编辑 模式 ”进入 设置 页 面 ， 如 图 2-2 所 示 。 


1) 点 击 开启 模式 总 开关 ， 自 动 回复 的 “启用 ”按钮 才 会 显示 出 来 。 


2) 点 击 自动 回复 的 “启用 ”按钮 ， 就 可 以 设置 自动 回复 消息 了 。 


这 时 完全 通过 人 工 回 复 不 仅 效率 较 
运营 者 。 下 面 我 们 将 带 


目 动 回复 


针对 用 户 的 行 


作为 目 动 回 复 。 


复 让 屿 。 


图 2-2 


局 


2.2 自动 回复 江 


\ 众 号 提供 的 强大 工具 ， 通 过 设置 自动 回复 消息 不 但 能 引 
消息 自动 回复 和 关键 词 自动 回复 。 


自动 回复 消息 是 微 信 为 公 
供 了 三 种 自动 回复 ， 分 别 是 : 被 添加 自动 回复 、 


2.2.1 添加 自动 回复 


当 用 户 关注 公众 号 就 会 发 出 该 自动 回复 ， 该 自动 回复 主要 用 于 发 送 欢 迎 信息 和 功能 说 明 ， 引 导 用 户 了 解 公 


息 可 以 是 文字 、 图 片 、 语 音 和 视频 ， 如 图 2-3 所 示 。 


编辑 模式 开 友 模式 


公 傣 平台 如 们 这 音 被 闵 加 目 动 回 复 ? 


被 添加 自动 回复 
志文 字 [Wj 图片” 准 语 音 。 国 4 视频 


亲 过 的 朋友 ， 欢迎 关注 兔子 ， 么 么 哎 


【1]】 回 复 “h” 间 看 历史 文章 


【2] 回复 ”t+ ”查看 公共 号 功能 


图 2-3 


Oi5 欢迎 信息 内 容 不 要 过 多 ， 也 不 要 太 简 单 ， 设 置 一 些 艺术 字体 ， 让 你 的 欢迎 信息 更 个 性 。 微 信里 有 一 种 特殊 表情 ， 当 输入 特定 文字 会 有 彩蛋 表情 


么 么 呈 、missu、 想 你 了 :…… 在 欢迎 消息 中 包括 这 些 文字 ， 也 能 让 你 的 公众 号 更 加 出 彩 。 


么 蚊 ”， 在 手机 上 呈现 的 效果 如 图 2-4 所 示 。 





| 导 用 户 方便 地 使 用 公众 号 ， 还 能 提高 用 户 体验 。 


众 号 的 定位 ， 帮 助 用 户 正确 地 使 用 该 公众 号 





2 国生 


J 为 ， 你 可 以 县 十 特定 的 文字 、 语 彰 、 图 上 月、 孙 彰 来 
当 用 户 符 合 你 所 制定 的 规则 时 ， 就 会 收 到 目 动 加 


点 击 “ 设 置 ”， 进 入 自动 回复 消息 设置 页 面 ， 在 右 侧 我 们 看 到 ， 微 信 提 


运营 者 互动 沟通 。 回 复 消 


， 方 便 用 户 与 微 信 公众 号 


被 泳 加 自动 回复 
消息 上 自动 回复 
关键 词 自动 回复 


还 DJ 以 输入 222 字 


效果 ， 这 些 文字 包括 生日 快乐 、 茶 喜 发 财 、 





达 呐 注 免 子 ， 你 





be i 下 
| 旧 皇 | 本 Pa 
| 和 Fa 3 时 局 本 
md | “py 目 二 [ 证 
,Mw | 


【 1】 回复 'h' 查 看 历史 文章 


图 2-4 


2.2.2 ”消息 自动 回复 


如 果 用 户 输 入 一 些 没 在 后 台 设 置 好 的 关键 词 或 者 无 效 消 息 ， 系 统 将 发 送 该 消息 ， 用 于 提醒 用 户 输入 正确 的 关键 词 ， 以 正确 的 方式 与 公众 号 进行 沟通 。 这 里 的 设置 是 至 关 重要 的 ， 否 则 当 用 户 输入 无 效 信 


息 ， 公 众 号 将 不 会 发 送 任何 消息 给 用 户 ， 这 会 给 用 户 一 个 错觉 ， 以 为 公众 号 不 工作 了 ， 不 知道 问题 出 在 自己 身上 。 自 动 回复 消息 也 有 四 种 类 型 : 文字 、 图 片 、 语 音 和 视频 ， 如 图 2-5 所 示 。 


编辑 模式 开 皮 模式 


被 添加 自动 回复 
消息 自动 回复 
关键 词 自动 回复 


消息 自动 回复 公众 平台 如 何 设置 消息 自动 回复 ? 
于 [图片 ” 座 语音 视频 
[兔子 不 在 电脑 旁 ， 给 你 看 个 笑话 先 ] 今 天 地 铁 遇 一 老 太 太 ， 说 借 我 手机 用 用 ， 给 他 


儿子 打 电 话 ， 找 听 了 圭 断 给 她 拔 通 。 打 了 个 浊 力 分 钟 ， 完 了 匈 舌 要塞 给 牧 购 块 钱 ， 
找 匈 舌 不 要， 老 太 太 买 在 撩 个 过 牧 。 结 未 ， 她 一 着 急 ， 当 着 闭 么 多 人 的 血 喊 道 : 活 
雷锋 ! 快 抓 活 雷 锋 了 ! 快 来 人 了 ! 





消息 自动 回复 在 手机 上 呈现 的 效果 ， 如 图 2-6 所 示 。 


小 兔子 乖乖 ~ - 











2.2.3 ”关键 词 自动 回复 


关键 词 自动 回复 是 当 用 户 输入 的 文字 满足 设 定好 的 关键 词 规则 时 ， 公 众 号 会 把 设置 在 此 规则 中 的 内 容 自动 发 送 给 用 户 。 


点 击 “ 添 加 规则 ”按钮 ， 如 图 2-7 所 示 ， 我 们 可 以 看 到 每 条 规则 都 包括 三 部 分 : 规则 名 、 关 键 字 、 回 复 。 


编辑 模式 开 友 模式 


漆 加 规则 被 添加 自动 回复 
收 起 消息 自动 回复 
关键 词 自动 回复 


A 文字 图片 ”六 语音 国 4( 视 频 [图 文 


文字 (0)、 图 片 (0)、 语音 (0)、 视 频 (0)、 图 文 (0) 删除 





“规则 名 ”: 方便 用 户 识 别 ， 根 据 规则 的 用 处 做 合理 的 命名 即 可 。 
" “关键 字 ”: 当 用 户 输入 的 词 与 关键 字 匹 配 ， 该 规则 就 会 触发 。 每 条 规则 可 以 设置 最 多 10 条 关键 字 (每 条 关键 字 最 多 可 设置 30 个 汉字 ) 。 
“回复 ”: 当 用 户 输 入 的 词语 触发 了 规则 时 ， 公 众 号 就 会 回复 设置 的 内 容 ， 可 以 是 文字 、 图 片 、 语 音 、 视 频 和 图 文 消息 。 每 条 规则 最 多 可 以 设置 5 条 回复 (每 条 回复 最 多 可 设置 300 个 汉字 ) 。 


读者 可 能 会 考虑 到 这 样 一 种 情况 ， 用 户 想 查找 某 条 信息 ， 但 不 清楚 该 如 何 输 入 精确 的 关键 字 ， 规 则 的 关键 字 设 置 也 不 可 能 考虑 到 用 户 的 所 有 可 能 输入 。 如 图 2-8 所 示 ， 我 们 发 现 关 键 字 的 设 定 包括 一 
个 “未 全 匹配 ”选项 ， 这 是 指 用 户 的 输入 包括 这 个 关键 字 就 算 匹 配 该 关键 字 ， 比 如 关键 字 “ 讲 经 ”， 用 户 输入 的 是 “ 听 老 师 讲 经 ” ， 就 会 触发 规则 。 默 认 是 “未 全 匹配 ”， 也 可 以 切换 成 “已 全 匹配 ”， 这 
时 用 户 输入 的 词语 必须 与 关键 字 一 致 才 会 触发 规则 。 


图 2-8 中 包含 一 个 “回复 全 部 ”选项 ， 如 果 勾 选 上 ， 当 规则 被 触发 时 公众 号 会 回复 该 规则 内 的 所 有 的 回复 ， 若 未 勾 选 ， 则 随机 回复 。 


当 输 入 “ 讲 经 ”符合 规则 1 的 关键 字 设置 ， 公 众 号 就 会 发 送 一 个 图 文 消息 给 用 户 ， 如 图 2-9 所 示 。 











讲 经 





听 老 是 讲 经 之 一 
3 月 17 晶 


dd 
"出 站 并 讽 


六 





晶 
3 





2.2.4 ”自动 回复 优先 规则 


如 果 同 时 设置 了 关键 词 自动 回复 和 消息 自动 回复 ， 那 么 就 存在 优先 级 的 问题 ， 常 理 来 说 ， 应 该 优先 触发 关键 词 自动 回复 规则 ， 如 果 没 有 满足 的 关键 字 再 触发 消息 自动 回复 规则 ， 实 际 上 微 信 公众 号 也 是 


这 么 处 理 的 。 
Oi5 微 信 说 明文 档 中 指出 文字 中 可 以 输入 网 页 链接 地 址 ， 但 不 支持 设置 超 链 接 。 如 果 用 户 了 解 一 些 html 的 知识 ， 完 全 可 以 自己 设置 超 链接 效果 。 通 过 <a> 标 签 将 文本 中 的 某 些 文字 链接 到 其 他 网 页 


上 。 如 图 2-11 所 示 ， 这 里 对 文字 “ 必 应 ”设置 了 超 链 接 效果 。 


添加 回复 文字 


吴 了 歌 雅 韵 有 求 <a href="http;f/cn.bing.com/ > 必 应 </a> 


还 可 以 输入 257 字 





图 2-10 


必 有 应 





” 吴 歌 雅 的 有 求 必 应 





图 2-11 


i \\ 二 
2.3” 自 定义 菜单 
2013 年 3 月 19 日 ， 公 众 平台 开放 了 “ 自 定义 荣 单 ”的 内 测 申请 。 当 时 引起 不 小 的 万 动 ， 不 少 公众 账号 的 运营 者 纷纷 求 内 测 资格 ， 希 望 为 自己 的 账号 加 上 自 定义 菜单 功能 。2013 年 8 月 5 日 ， 公 众 平台 将 公 


众 账号 分 为 订阅 号 和 服务 号 。 服 务 号 只 能 由 运营 主体 为 组 织 的 账号 申请 ， 并 且 可 以 申请 自 定义 菜单 。 通 过 微 博 认证 的 订阅 号 也 可 以 申请 自 定 义 菜 单 。 


2.3.1 设置 目 定 义 荣 单 


可 以 通过 “功能 ”一 “高 级 功能 ”一 “编辑 模式 ”找到 自 定 义 菜单 。 点 击 “ 设 置 ”， 进 入 自 定义 菜单 的 设置 页 面 ， 如 图 2-12 所 示 。 


Si 开发 档 并 


©O 编辑 模式 已 开启 


目 动 回复 


针对 用 户 旬 行为 ,你 可 以 设 定 特定 的 区 字 、 识 音 、 图 片 、 孙 音 
来 作为 自动 回复 ， 当 用 户 符合 你 所 制定 的 规则 时 ， 就 会 要 到 和 
动 回复 消息 


自 定义 菜单 


星 品 背后 的 奇 纪 与 感 以 在 会 请 蹇 加 底部 丰年 自 定 必 匠 单 ， 荣 单 丙 吕 按 需 


ee | 前 所 未 有 的 滋味 ， 轴 打 为 其 座 [和 Fi ps p ,而 汪 
二 感 从 何 而 来 ? 宇 ， 亲 为 没 守 几 应 动作。 用 庆 可 以 上 地 页 履 


最 受 次 迎 我 的 收藏 : 
在 法 音 服 | 音 卢 中 心 
反 饥 言 号 : weixingongzhong 





图 2-12 


点 击 “ 添 加 ”按钮 ， 如 图 2-13 所 示 ， 可 以 依次 添加 一 级 菜单 ， 并 在 一 级 菜单 下 添加 二 级 菜单 。 菜 单 名 称 不 能 多 于 4 个 汉字 或 8 个 字母 。 最 多 可 创建 3 个 一 级 菜单 ， 每 个 一 级 菜单 下 最 多 可 创建 5 个 二 级 菜 


在 创建 的 过 程 中 ， 读 者 可 以 随时 点 击 “ 预 览 ”按钮 ， 查 看 自 定义 菜单 的 效果 ， 如 图 2-14 所 示 。 


洗 轧 档 款 开 点 模式 


目 定 义 荣 单 


志 辑 


可 创建 最 他 3 个 一 租 菜 单 ， 每 个 一 租 藻 音 下 可 创 陵 最 他 5 沾 二 级 菜单 。 闹 蛤 中 的 菜单 不 会 马上 被 用 户 看 到 ， 请 放心 调 斌 . 


菜单 各 理 | 排序 ”设置 动作 


r 和 锡 了 社区 十 面 


订 鸭 者 就 市 说 子 菜单 党 毕 到 | 下 链接 


= 联 竹 我 httpAww wsq.q9q.com214671676 


-关于 我 






个 衣 吝 接 在 用 户 手 机 上 生效 ， 你 需要 进行 点 布 ， 点 布 后 半 小 时 内 所 有 的 用 户 剖 柠 更 新 刘 新 的 莹 单 。 








i 


图 2-13 


个 一 





图 2-14 


2.3.2 ”设置 动作 





可 以 为 每 个 菜单 项 设置 动作 。 选 中 菜单 项 后 ， 右 侧 会 出 现 “ 设 置 动作 ”的 页 面 ,读者 可 以 选择 “发 送 消 息 ” 或 “ 跳 转 到 网 页 ， 如 图 2-15 所 示 。 


侵 间 动作 


请 选择 订 疯 者 局 击 荣 单 后 ， 人 公众 三 做 出 的 相应 动作 





图 2-15 


发 送 消息 ， 意 味 着 微 信用 户 点 击 后 ， 回 复 给 用 户 一 条 消息 。 目 前 支持 的 消息 类 型 有 文字 、 图 片 、 语 音 、 视 频 和 图 文 消 息 ， 如 图 2-16 所 示 。 
设置 动作 
订阅 者 点 击 该 子 荣 单 会 收 到 以 下 消息 
网 文字 加 图 片 “” 坊 语音 国 4 视 频 图 文 消息 


我 是 兔子 (wD 


不 吕 以 办 和 人 293 耶 





图 2-16 


跳 转 到 网 页 ， 即 用 户 点 击 后 ， 跳 转 到 一 个 网 页 。 微 社区 (http://wsq.qq.com/) 已 开放 申请 ， 很 多 公众 账号 都 把 一 个 菜单 项 设置 为 自己 的 微 社 区 链接 。 如 图 2-17 所 示 ， 点 击 “ 免 子 社区 ”后 ， 将 跳 转 到 
兔子 的 微 社区 页 面 。 


需要 注意 的 是 ,创建 的 菜单 不 会 立即 生效 ， 有 24 小 时 的 缓存 时 间 。 读 者 如 需 立 刻 看 到 效果 ， 可 以 先 取消 关注 ， 青 重新 添加 关注 即 可 。 


自 定 义 菜单 的 实际 效果 如 图 2-18 所 示 。 
































免 子 DV 


1 话题 王 18 访 问 








david 
二 04-05 


申 和 园 的 育 





中 筑 所 分 享 (回复 





图 2-17 





图 2-18 


选择 硬 | 图 标 ， 即 可 弹出 “发 起 投票 ”页 面 。 在 页 面 上 可 设置 该 投票 的 相关 信息 ， 如 图 2-19 所 示 。 

运营 者 可 以 将 包含 投票 的 图 文 消息 群发 出 去 ( 见 图 2-20) 。 只 有 群发 出 去 ， 才 能 收 到 用 户 的 投票 并 查看 投票 结果 。 
用 户 收 到 推送 的 图 文 消息 后 ， 可 以 选择 选项 进行 投票 ( 见 图 2-21) 。 

股票 后 能 看 到 投票 结果 ( 见 图 2-22) 。 

把 包含 投票 的 图 文 消息 群发 出 去 之 后 ， 运 营 者 可 以 在 “群发 功能 ”一 “已 发 送 ” 选 项 卡 中 查看 投票 结果 ( 见 图 2-23) 。 


注意 ， 每 个 图 文 消息 最 多 只 能 包含 一 个 投票 。 当 用 户 试图 添加 多 个 投票 时 ， 会 弹出 警告 并 显示 添加 失败 。 


入 票 是 一 个 运营 者 征集 用 户 意 见 ， 决 定 最 终结 果 的 好 方法 。 微 信 公 众 平台 在 2014 年 5 月 9 日 增加 了 投票 功能 ， 公 众 号 的 运营 者 可 以 在 图 文 消息 编辑 框 中 ， 添 加 一 个 图 片 投 票 。 


发 起 投票 


投 要 主题 
在 你 的 家 多 粽子 星 甜 的 还 星 咸 的 ? 





ES 


国 投票 为 单 选 人) 投票 为 多 选 
报 村 截止 时 间 
| 2014-06-06 国 | 时 分 


选项 说 直 ( 最 多 设 直 6 个 选项 ) 


选项 一 | 和 
选项 一 | 威 : 
选项 三 | 都 有 删 队 


图 2-19 





欢迎 苑 投票 ! 


在 你 的 家 乡 粽子 是 型 的 还 是 咸 的 ? 
以 下 选项 为 单 先 


i: 
〇 成 
1 上 四 


al 





在 你 的 家 乡 粽 子 是 甜 的 还 是 感 的 ? 
计 1A.、 100% 


咸 0 人 0% 


部 有 0 人 





图 2-22 


投票 结果 


在 你 的 家 乡 粽子 是 垂 的 还 是 咸 的 ? 


2014/06/03 21:09 开 始 ， 2014/06/06 00:00 结 束 ， 共 1 人 参与 


1. 甜 1 人 100% 

ES==e== 玫 = 二 宣 | 

2. 威 0 人 0% 

3. 都 有 0 人 0% 
图 2-23 


本 节 通 过 两 个 小 案例 ， 来 说 明 自 动 回 复 和 自 定义 菜单 的 使 用 及 运营 方法 。 


2.5.1 ”利用 自动 回复 实现 我 的 书目 功能 
不 知道 读 者 有 没有 订阅 一 些 自 媒体 账号 ? 如果 订阅 了 ， 很 有 可 能 见 过 这 样 的 功能 : 回复 “书目 ”可 以 查看 作者 的 历史 文章 书目 ， 回 复数 字 可 以 访问 相应 的 文章 。 现 在 你 也 可 以 实现 这 样 的 功能 啦 ! 
1) 首先 要 设置 一 些 引导 文字 ， 在 公众 号 被 添加 或 用 户 发 消息 时 自动 回复 给 用 户 。 
在 自动 回复 的 设置 页 ， 分 别 设置 被 添加 自动 回复 和 消息 自动 回复 的 引导 文字 ， 如 图 2-7 和 图 2-8 所 示 。 在 用 户 关注 公众 号 或 发 送 消息 时 ， 会 回复 给 用 户 。 


2) 这 时 你 需要 在 “管理 ”一 “素材 管理 ”页 面 ， 新 建 一 个 全 文 目录 的 图 文 消息 ， 如 图 2-24 所 示 。 


全 文 目录 


二 秘 信 号 :hucyaxigctu 





这 是 郑 牙 小 免 的 微 信 huoyaxiaotu。 人 类 一 思考 ， 上 和 就 发 笑 ; 看 没有 思考 ， 又 与 草 
木 何 异 ?一半 欢乐 ,一 半 思 考 。 关 注 我 的 微 信 号 ， 能 收 到 我 的 最 新 文章 推送 。 

本 文 是 全 文 文章 目录 。 通 过 查看 文章 目录 ， 回 复 文章 编号 查看 对 应 文章 全 文 。 例 如 : 
回复 002， 束 能 查看 《世界 因 你 而 不 同 》 

001 兔 的 形象 

002 世界 因 你 而 不 同 

003 平衡 

004 如 歌 的 行 板 

005 父亲 

006 塑料 儿 章 

007 一 生 所 爱 

008 最 开心 的 事 

09 向 


图 2-24 


1) 为 文章 目录 设置 关键 词 自动 回复 规则 ， 如 图 2-25 所 示 。 








。 规则 名 文章 目录 ] 


规则 名 最 多 60 个 字 


hn 


文章 列表 





* 回复 回复 全 部 
Hp 文字 图片” 妨 语 音 国 ( 视 频 回 图 文 


[图 对 消息 | 全 广 目 夭 

这 是 者 牙 小 免 的 微 信 huoyaxiaotu。 人 类 一 思 
者 ， 上 帝 就 发 笑 ; 没有 思考 ， 又 与 草木 何 异 
? 一半 欢乐 ， 一半 思 








图 2-25 


2) 为 每 篇 文章 设置 关键 词 自动 回复 规则 ， 图 2-26 所 示 。 


规则 4: 文章 003 展开 


关键 记 003 
回复 1 条 ( 0 条 文字 ，0 条 图 片 ，0 条 语音 ，0 条 视频 ，1 条 图 文 ) 


规则 3: 文章 002 展开 


关键 词 002 
回复 1 条 ( (0 条 文字 ，0 条 图 片 ，0 条 语音 ，0 条 视频 ，1 条 图 文 ) 

规则 2: 文章 001 殿 上 
关键 词 001 

回复 1 条 ( 0 条 文字 ，0 条 图 片 ，0 条 语音 ，0 条 视频 ，1 条 图 文 ) 


图 “2-26 


经 过 以 上 几 个 步骤 ， 一 个 简易 书目 就 做 好 了 ， 效 果 如 图 2-27 和 图 2-28 所 示 。 








Xa 。 攻 罕 的 朋友 ,欢迎 关注 免 
~ 

【1】 回复 "各 看 历史 文章 
【2 】 回 复 + 查看 公众 号 功 
能 





文 是 第 才 小 总 的 向 恒 huoyaxiaoctUu。 信 夫 一 思 
者 ， 上 帝 就 发 笑 ; 若 没 有 思考 ， 叉 与 草木 何 异 ? 


i 
Me 
是 
加 


只) Gal EE | 








免 是 兽 类 中 最 情 弱 无 能 的 动物 ， 它 在 四 面 是 敌 的 
环境 中 得 以 生存 ,惟一 的 “本领 ”, 就 是 跑 。 


查看 全 区 


图 2-28 


2.5.2 ”和 目 定义 菜 蛙 的 典型 案例 : 小 道 消息 
自 定义 菜单 最 多 可 以 创建 3 个 一 级 菜单 ， 每 个 一 级 菜单 下 最 多 可 创建 5 个 二 级 菜单 。 数 量 上 的 限制 ， 加 上 手机 屏幕 的 限制 ， 使 得 在 设计 自 定义 菜单 时 ， 一 定 要 把 对 用 户 最 有 用 ， 使 用 频率 最 高 的 功能 放 在 
自 定义 菜单 的 显著 位 置 ， 不 太 重要 或 不 太 常用 的 功能 放 在 第 二 级 菜单 中 ， 甚 至 不 放 。 这 里 有 一 个 成 功 案例 ， 跟 读者 分 享 一 下 ，。 


小 道 消息 (WebNotes) 是 一 个 很 成 功 的 微 信 公众 账号 ， 其 主人 为 Fenng (丁香 园 技 术 负 责 人 冯 大 辉 ) 。Fenng 以 思想 独特 、 文 笔 犀利 、 消 息 灵通 著称 ， 微 博 粉 丝 104 万 ， 微 信 公 众 号 关注 者 超过 26 
万 ， 属 于 最 早 的 个 人 微 信 公众 号 之 一 。 


之 所 以 举 小 道 消息 的 例子 ， 是 因为 其 自 定义 菜单 设置 非常 典型 且 实 用 。 
如 图 2-29 所 示 ， 有 3 个 一 级 菜单 : 更 多 阅读 、 小 道 社区 、 与 我 联系 。 
更 多 阅读 存放 的 是 小 道 消息 文章 的 备份 。 用 户 订阅 小 道 消息 ， 大 多 是 为 了 阅读 他 的 文章 ， 因 为 有 料 、 幽 默 、 有 启发 ， 所 以 将 文章 备份 放 在 第 一 位 ， 方 便 后 来 的 订阅 者 查看 以 前 的 文章 。 


小 道 社区 是 较 早 获得 内 测 资 格 的 微 社区 ， 用 户 发 言 很 活跃 。 放 在 第 二 位 可 以 使 用 户 之 间 互 相交 流 ， 带 来 更 好 的 互动 体验 。 


与 我 联系 则 包含 了 3 个 二 级 菜单 : 合作 联系 返回 Fenng 的 邮箱 和 QQ 号 ， 满 足 用户 合 作 或 求助 的 需求 ; 赞助 小 道 为 用 户 提 供 了 赞助 的 渠道 ; 作者 简介 则 主要 介绍 小 道 消息 关注 的 领域 和 文章 内 容 。 


按 : 这 十 我 朋 几 大 在 it “会 1 ， 合作 联系 
容 。 会 务 组 对 我 的 15 分 钟 演 讲 进 和 


我 今天 重新 做 了 一 点 修正 。 
迁 助 小 道 


查看 全 文 


| 更 多 阅读 | 小 道 社区 与 我 联系 





图 2-29 


读者 在 设计 自己 的 自 定 义 菜单 时 ， 应 注意 有 所 取舍 ， 突 出 重点 ， 不 要 做 功能 堆砌 ， 用 户 喜 欢 才 是 王道 。 


第 3 章 ”搭建 开 友 环境 


第 2 章 详 细 介 绍 了 公众 平台 编辑 模式 的 用 法 ， 通 过 学 习 ， 读 者 应 该 掌握 设置 自动 回复 、 自 定义 菜单 等 运营 方法 。 但 是 ， 公 众 平台 提供 的 众多 接口 ， 包 括 事件 推送 、 语 音 识别 、 客 服 接口 、 二 维 码 等 ， 需 要 
在 开发 模式 下 使 用 。 


本 章 主 要 介绍 如 何 局 用 开发 模式 ， 并 介绍 如 何在 SAE 和 BAE 下 搭建 开发 环境 ， 最 后 通过 开发 第 一 个 应 用 ， 让 读者 了 解 公众 平台 开发 的 一 般 步 


3.1 局 用 公众 平台 开 友 候 陈 


公众 平台 提供 了 编辑 模式 和 开发 模式 ， 两 种 模式 互 斥 ， 不 能 同时 开启 ， 但 可 以 随时 切换 。 


依次 点 击 “ 功 能 ”一 “高 级 功能 ”， 可 以 看 到 这 两 种 模式 ， 点 击 进入 开发 模式 ， 如 图 3-1 所 示 。 


高 级 功能 【只 可 局 用 一 种 乙未 ) 





弓 辑 模式 开 皮 模式 


在 此 楼 式 下 ，9JL 办 曾 过 漳 单 的 卉 面 编辑 ， “在 此 柳 式 下 ， 开 发 者 可 以 通过 公众 平台 担 
素 训 年 目 动 回复 。 服 务 三 壕 有 会 大 三 话 部 | 性 的 接口 “实现 自动 回复 ， 鞭 取 订 阅 者 . 
目 定 区 于 甲 等 功 角 。 上 自 走 兴 荣 单 等 功 朋 ， 


| @ Efe \ 和 Ex 





如 果 当 前 已 启用 了 编辑 模式 ， 打 开 开 发 模式 会 有 错误 提示 ， 需 要 先天 闭 编 辑 模式 才能 成 功 进 入 开发 模式 ， 如 图 3-2 所 示 。 


塘 相 模式 已 启用 ， 无法 同时 开启 开发 模式 。 情 关 问 彤 栓 模 式 后 ,再 量 
坏 . 





本 节 主 要 介绍 开发 模式 的 启用 和 网 址 接 入 。 


3.1.1 ”申请 网 址 接 入 
成 为 公众 平台 开发 者 之 前 ， 需 要 做 一 些 准备 工作 。 


1. 公 网 服务 器 环境 


首先 要 保证 服务 器 处 于 公 网 环境 ， 在 个 人 电脑 上 部 署 的 服务 器 ， 一 般 通 过 127.0.0.1 或 localhost 访 问 。 而 127.0.0.1 是 回 送 地 址 (Loopback Address) ， 只 能 在 本 地 机 器 上 使 用 。 常 见 的 公 网 服务 器 可 以 
通过 购买 虚拟 主机 、 使 用 SAE 或 BAE 等 云 服务 、 利 用 花生 壳 动 态 解析 等 方式 获得 。 


2.Token 验 证 程序 


在 开启 开发 模式 的 过 程 中 ， 需 要 填写 URL 和 Token， 其 中 URL 是 开发 者 用 来 接收 微 信 务 器 数据 的 接口 URL。Token 可 由 开发 者 任意 填写 ， 用 作 生 成 签名 (该 Token 会 和 接口 URL 中 包含 的 Token 进 行 比 
对 ， 从 而 验证 安全 性 ) 。 这 部 分 内 容 会 在 第 4 章 详细 说 明 。 


在 公众 平台 中 ， 依 次 点 击 “ 功 能 ”一 “高 级 功能 ”， 进 入 开发 模式 页 面 。 点 击 “ 成 为 开发 者 ”按钮 ， 填 写 URL 和 Token ( 见 图 3-3) ， 如 果 验 证 成 功 表明 接 入 生效 。 


接口 配置 信息 


请 填写 接口 配置 信息 ， 此 信息 需要 你 拥有 自己 的 服务 器 资源 。 填 写 的 URL 需 要 正确 响应 微 信 和 发送 的 Token 验 证 ， 请 阅读 消息 接口 使 用 指南 








URL | 必须 以 http:// 开 头 ， 目 前 支持 80 端 口 。 





Token | 洗 庆 为 天 义 或 数字 ,长度 为 3-32 字 符 。 
什 笃 星 Token? 


3.1.2 ”数据 交换 方式 

网 址 接 入 成 功 后 ， 开 发 者 会 立即 获得 消息 接口 权限 ， 而 消息 接口 为 开发 者 提供 了 与 用 户 进行 消息 交互 的 功能 。 当 普通 微 信用 户 向 公众 账号 发 消息 时 ， 微 信服 务 器 将 POST 消息 的 XM 数据 包 到 开发 者 填 
写 的 URL 上 。 开 发 者 的 URL 接 收 到 XM| 数 据 后 ， 通 常会 解析 XML、 区 分 消息 类 型 、 进 行 相应 处 理 ， 把 要 回复 的 内 容 拼装 成 XML 返回 给 微 信服 务 器 。 微 信服 务 器 再 将 消息 回复 给 微 信用 户 。 

图 3-4 为 微 信用 户 向 公众 账号 发 消息 并 获得 回复 的 数据 交换 过 程 。 

@: 微 信用 户 发 消息 到 微 信服 务 器 。 


@: 微 信服 务 器 将 消息 进行 预 处 理 ， 区 分 出 消息 类 型 ， 包 括 文本 消息 、 图 片 消息 、 语 音 消息 、 视 频 消息 、 地 理 位 置 消息 和 链接 消息 。 如 果 公众 账号 有 语音 识别 接口 权限 并 且 开 启 了 语音 识别 功能 ， 则 在 
语音 消息 中 增加 一 个 语音 识别 结果 的 字段 。 微 信服 务 器 将 消息 封装 为 XML 数据 后 ， 以 POST 的 方式 提交 给 开发 服务 器 。 微 信服 务 器 在 5 秒 内 收 不 到 响应 会 断 掉 和 连接， 并且 重新 发 起 请 求 ， 总 共 重 试 三 次 。 


@: 开发 服务 器 接收 到 微 信服 务 器 提交 的 数据 ， 根 据 开 发 者 需要 进行 处 理 。 如 需 给 用 户 回复 消息 ， 则 将 回复 消息 封装 为 XML 数据 ， 返 回 给 微 信服 务 器 。 现 在 支持 回复 文本 消息 、 图 片 消息 、 语 音 消息 、 
视频 消息 、 音 乐 消息 、 图 文 消息 。 如 果 不 需 要 回复 ， 可 以 直接 回复 空 串 ， 微 信服 务 器 不 会 对 此 作 任何 处 理 ， 并 且 不 会 发 起 重 试 . 


@: 微 信服 务 器 接收 到 开发 服务 器 提交 的 数据 后 ， 返 回 给 微 信用 户 。 







做 信服 务 器 





开发 服务 器 


3.1.3 ”接口 列表 


成 为 开发 者 之 后 ， 会 获得 公众 平台 的 接口 权限 ， 订 阅 号 只 能 使 用 普通 消息 接口 ， 通 过 认证 的 订阅 号 还 可 以 使 用 自 定义 菜单 接口 ， 而 通过 认证 的 服务 号 可 以 获得 几乎 所 有 接口 权限 。 


图 3-5 为 通过 认证 的 服务 号 可 以 使 用 的 服务 。 


接收 用户 消 垦 

向 用 户 回 复 消 息 

接受 事件 推送 

会 需 闪 加 目下 汉人 某 单 有 效 
普通 认证 

语音 识别 (已 关闭 ) 开启 

客服 接口 

OAuth2.0 网 风 授 要 修改 
生成 带 参 数 二 维 码 

获取 用 户 地 理 位 置 ( 已 关闭 ) 开启 | 2015-03-17 日 到 期 
获取 用 户 基 本 信息 

获取 关注 者 列表 

用 户 分 组 接口 

在 线 客 服 | 客服 中 心 上 传 下 载 多 媒体 文件 








2015-03-17 日 到 期 


区 局 官 号 : weixingongzhong 





服务 包 按 内 容 分 为 四 类 : 

“ 基础 接口 : 即 消息 接口 ， 包 括 接 收 用 户 消息 、 向 用 户 回复 消息 和 接受 事件 推送 。 
- 自 定义 菜单 : 编辑 模式 或 开发 模式 下 都 能 创建 、 修 改 或 删除 。 

. 微 信 认证 : 包括 加 V 和 搜索 排名 靠 前 。 


. 高 级 接口 : 包括 语音 识别 、 客 服 接口 、OAuth2.0 网 页 授权 、 生 成 带 参 数 二 维 码 、 获 取 用 户 地 理 位 置 、 获 取 用 户 基本 人 信息、 获取 关 注 者 列表 、 用 户 分 组 接口 、 上 传 下 载 多 媒体 文件 等 。 


3.2 ”SAE 环境 搭建 

Sina App Engine (SAE) 是 新 浪 公 司 (sina.com.cn) 推出 的 一 款 云 应 用 引擎， 自 2009 年 11 月 问世 后 ，SAE 一 直 受 到 开发 者 的 青睐 。 到 2013 年 11 月 止 ，SAE 已 经 有 近 40 万 开发 者 ， 共 托管 了 约 56 万 个 
应 用 。 一 些 成 熟 的 软件 和 框架 ， 如 WordPress、Codelngiter、YII 等 ， 都 被 移植 到 SAE。 其 中 WordPress 的 安装 次 数 已 经 超过 11 万 ， 异 常 火爆 。 

SAE 现 在 支持 多 种 语言 如 PHP、Java、Python， 采 用 不 同 技术 的 开发 者 都 可 以 使 用 SAE 服 务 。 除 了 网 页 应 用 ，SAE 也 有 移动 云 平台 ， 可 以 开发 移动 应 用 。 

SAE 吸 引 了 大 量 的 开发 者 。SAE 体 现 了 新 浪 的 一 贯 作风 : 一 流 客服 + 一 流 运营 ， 就 易 用 性 和 稳定 性 而 言 ， 要 远 远 超过 其 他 竞争 者 。 


这 里 从 应 用 创建 、 搭 建 本 地 开发 环境 和 SAE 常 用 服务 等 方面 ， 介 绍 如 何 搭建 基于 SAE 的 开发 环境 。 


3.2.1 应 用 创建 


1. 注 册 账 号 


SAE 采 用 新 浪 微 博 账号 体系 进行 登录 ， 所 以 你 需要 有 一 个 新 浪 微 博 账 号 或 邮箱 即 可 。 


进入 SAE 官 网 (http://sae.sina.com.cn/) ， 在 页 面 顶部 右上 角 可 以 看 到 “注册 ”链接 ， 如 图 3-6 所 示 。 


English | 苗 动 


| Q、 输入 想 要 搜索 的 关键 字 





图 3-6 


进入 了 “SAE 新 浪 云 计算 平台 ”的 登录 页 面 。 如 果 你 已 经 有 新 浪 微 博 账号 ， 在 此 页 面 输 入 账号 和 密码 ， 点 击 “ 登 录 ” 即 可 ， 如 图 3-7 所 示 。 


如 果 你 还 没有 新 浪 微 博 账号 ， 请 先 点 击 右 上 角 的 “注册 ”链接 ， 用 邮箱 注册 一 个 新 浪 微 博 账号 ， 再 返回 此 页 面 进行 登录 。 


登录 后 进入 授权 页 ， 点 击 “ 授 权 ” 按 钮 即 可 完成 注册 ， 如 图 3-8 所 示 。 

















(83 新 太 扰民 


weibo.com 





授权 SAE 新 浪 云 秆 算 平 癌 访问 你 的 向 博 帐 亏 ， 并 回 时 登录 者 良 做 博 





~ 


提示 : 为 悍 障 帐号 安全 ， 倩 计 准 本 内 URL 地 址 以: 欧 以 api.weibo.com 开头 





mm 
(7 新 浜 做 坊 favid | 我 的 应 用 | 换个 帐号 


we/bo.com 





EF 让 二 证 售 平 人 2 eA 
6 SAE 新 浪 云 计算 平台 和 者 :Sin ppE ngne 


将 部 诗 SAE 痢 痕 云 计算 半 合 进行 以 下 探 作 : 
皇 获得 你 的 个 人 信息 ， 好 友 天 系 
分 享 内 容 到 你 的 微 博 
圈 获得 你 的 评论 


| 取消 





提示 : 为 保障 帐 号 安全 ， 傅 认 准 本 肉 URL 地址 以 珊 以 api.weibo.com 开头 


至 此 ， 你 已 经 完成 了 SAE 的 注册 ，SAE 的 账号 就 是 你 的 微 博 账号 。 
2. 使 用 SVN 部 署 代码 


SAE 有 四 种 代码 管理 方式 : 在 线 安装 应 用 、 在 线 编辑 、 本 地 开发 环境 上 传 和 和 SVN 部署。 


在 线 安装 应 用 的 方式 ， 适 用 于 安装 SAE 应 用 仓库 (http://sae.sina.com.cn/?m=appstore) 里 的 Web 应 用 和 开发 框架 ， 安 装 后 可 以 直接 使 用 。 这 类 应 用 包括 开源 博客 系统 WordPress、 开 源 PHP 框 架 
Codelgniter、Yi 浅 9ThinkPHP 等 。 后 续 需要 修改 代码 ， 可 以 通过 在 线 编辑 和 SVN 等 方式 实现 。 


为 方便 用 户 在 线 编辑 代码 ，SAE 提 供 了 在 线 编辑 器 ， 通 过 在 线 编辑 器 可 以 创建 、 编 辑 、 上 传代 码 和 文件 。 在 线 编辑 器 可 以 在 应 用 的 “代码 管理 ”部 分 找到 ， 如 图 3-10 所 示 。 如 果 通 过 在 线 代码 编辑 器 对 
代码 进行 修改 、 部 署 等 操作 ， 也 会 和 执行 sSvn commit 一 样 ， 产 生 一 个 新 的 提交 ， 即 可 以 使 用 SVN 客 户 端 执行 svn update 获取 最 近 的 更 新 或 其 他 操作 。 


SAE 代 码 部 署 原理 图 








| BP 车 代码 
SVN 客 户 端 





WVeb 
runtime 


创建 一 个 版 本 





已 用 : 8.2M/100M | 八 码 空间 扩容 





到 丰 入 从 版 本 xhprof 周 试 


© 2011-11-16 20:20:27 http://1.ru... 关闭 显 示 这 1 
| 回 |: 
全 2 2012-02-24 15:52:17 http: /12.ru... | 关闭 蝇 示 编辑 信 码 
| 上 传代 码 包 


oO@ 2012-10-07 23:49:44 http://4.ru. | 天 闭 显示 | 办 


图 3-10 
本 地 开发 环境 见 3.2.2 节 。 
这 里 推荐 SVN 部 署 ， 其 优势 在 于 ， 对 代码 的 任何 修改 都 有 记录 ， 可 以 回 退 到 任意 历史 版 本 。 
在 Windows 下 开发 应 用 ， 推 荐 使 用 Tortoise SVN 客 户 端 ， 下 载 地 址 为 : http://tortoisesvn.net/downloads.html。 应 用 对 应 的 SVN 配 置 如 下 : 
“SVN 仓库 地 址 : https://svn.sinaapp.com/YOUR_APP_NAME 


"SVN 用 户 名 : SAE 安 全 邮箱 





. SVN 密 码 : SAE 安 全 密码 
完成 了 账号 申请 和 SVN 安 装 ， 接 下 来 就 可 以 开始 创建 第 一 个 应 用 了 。 
首先 登录 SAE， 访 问 我 的 首页 (http://sae.sina.com.cn/?m=dashboard) ， 单 击 “ 创 建新 应 用 ”按钮 ， 如 图 3-11 所 示 。 


页 面 会 弹出 提醒 ， 禁 止 创建 包含 违法 、 违 规 或 “擦边球 ”内 容 的 应 用 ， 如 图 3-12 所 示 。 


数据 分 析 找 的 账单 找 的 配 领 


状态 云 辟 消耗 ( 近 30 天 ) 访问 量 PV{ 近 30 天 )》 





图 3-11 


SAE 提 醒 您 


应 用 创建 提示 

SAE 荣 止 放 站 仿 目 喇 牌 类 网 站 、 私 服 、 雪 由 SEO、 游 戏 币 交易 、 获 用 外 和 宵 上 售 、 防 身 司 材 、 
色情 如 提供 聊天 、 技 摩 寺 )、 侦探、 涉 政 、 贿 博 、 贿 县 、 却 合 彩 、 成 作用 损 、 作 
牟 、 乔 鱼 由 、 垃 圾 邮件 、 因 qa 稍 售 、 保健 搞 稍 售 、 医疗 和 天 等 忆 合 但 不 限于 以 上 举例 和 


法 律 法 规 禁 止 的 内 容 ! 
如 您 的 应 用 包 念 违法 、 违规 内 容 ， 可 能 会 被 封禁 三 号 。 
具体 管理 规 刚 请 戎 考 | 管理 规定 |。 





图 3-12 


填写 二 级 域名 、 应 用 名 称 等 ， 单 击 “ 创 建 应 用 ”按钮 ， 应 用 就 被 创建 了 ， 如 图 3-13 所 示 。 所 填写 的 域名 就 是 应 用 的 访问 地 址 。 需 要 注意 的 是 应 用 创建 后 ， 二 级 域名 和 开发 语言 不 可 修改 ， 请 慎重 填写 。 


亨 建 新 应 用 渤 择 开 尾 框架 不 性 技术 ? 一 笛 灾 装 云 商店 热门 应 用 


* 报 域 名 《apPID) | weixinproject100 Lsinaapp.com | 
避 多 许 由 数字 ,字母 组 成 ， 长度 为 重 |18 位 。 唯一 标识 ,也 是 一 汲 域 名 前 强 , 创建 后 不 可 修改 。 


应 用 首 称 | 微 信 开 发 
应 用 的 中 文 名 称 ， 供 显示 用 。 





fs eB opython 。 乞 ava 


应 用 剖 建 后 ， 开 点 语言 不 可 个 履 


应 用 尖 型 ” 国 web 应 用 夸 陷 动 应 用 





图 3-13 


现在 选择 你 的 本 地 工作 目录 ， 如 G'Nsae。 单 击 鼠 标 右键 ， 在 弹出 的 菜单 中 选择 “SVN Checkout” 命 令 ， 如 图 3-14 所 示 。 























接骨 重 冀 名 上) Ctrl+Z 





夫 孚 (H) 


SYN Checkeout 
TortorseSVN 








[ww 
屋 性 (R) 








图 3-14 


在 弹出 页 面 中 填写 仓库 路 径 ， 如 : https://svn.sinaapp.com/weixinproject100 (其 中 weixinproject 100 是 刚 创建 的 应 用 名 称 ) ， 如 图 3-15 所 示 。 





https: //svn.sinaapp.com/weixinproject100/ 


| _| Multiple, independent working copies 


Chedwout Depth 





图 3-15 


单 击 “OK“ 按钮 开始 执行 update 操 作 ， 如 果 是 第 一 次 使 用 会 弹出 Authentication 窗 口 进行 身份 验证 (另外 ， 如 果 不 希 望 每 次 使 用 都 进行 身份 验证 ， 可 以 勾 选 “Save authentication” 复 选 框 ) ， 如 图 
3-16 所 示 。 


<httpe: //svn.sinaapp.com:443> SAE User Auth for SVN 


Regqguests a username and a password 





图 3-10 


` username: 注册 SAE 时 填写 的 安全 邮箱 (并 非 微 博 账号 ) 

* password: 注册 SAE 时 填写 的 安全 密码 (并 非 微 博 密码 ) 

身份 验证 成 功 后 SVN 会 自动 将 应 用 同步 到 本 地 工作 目录 中 并 创建 以 应 用 命名 的 文件 来。 

接 下 来 需要 创建 一 个 版 本 ， 在 该 文件 夹 中 创建 一 个 新 的 文件 夹 作为 这 个 应 用 的 版 本 (注意 文件 夹 的 名 称 就 是 应 用 的 版 本 号 ， 必 须 是 正 整数 ) 。 


现在 可 以 使 用 你 最 喜欢 的 编码 工具 (如 : EditPlus、Notepad++ 等 ) 在 该 文件 夹 下 创建 你 的 第 一 个 页 面 ， 如 index.php (如 果 你 创建 的 是 PHP 应 用 ) ， 文 件 内 容 如 下 : 





<?php 





echo ' Welcome to SAE!'; 
?> 
完成 后 ， 该 文件 左 侧 会 出 现 一 个 红色 的 “! ” ， 右 键 单 击 该 文件 ， 在 弹出 的 菜单 中 选择 “SVN Commithttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/...”， 执行 提交 操作 ， 如 图 3-17 所 示 。 





图 3-17 


在 弹出 窗口 的 Message 处 填写 更 新 的 理由 ,点击 “Ok”， 即 可 完成 代码 的 上 传 。 


现在 ， 在 浏览 器 中 输入 应 用 的 地 址 ， 就 可 以 马上 访问 。 本 例 地 址 为 http://weixinproject100.sinaapp.com (其 中 weixinproject100 为 应 用 名 称 ) ， 如 图 3-18 所 示 。 


€ 3 CC | weixinproject100.sinaapp.com 


Yelcome to AE! 





图 3-18 
[1] 此 图 源 于 SAE 官 网 。 


3.2.2 ”搭建 本 地 开发 环境 


为 方便 开发 者 测试 开发 ，SAE 提 供 了 本 地 开发 环境 。 它 们 能 模拟 SAE 的 大 部 分 功能 和 服务 ， 在 本 地 开发 环境 中 进行 开发 调试 ， 无 须 频 繁 地 上 传代 码 ， 不 但 节省 时 间 ， 而 且 减 少 调试 程序 时 调用 SAE 服 务 造 
成 的 云 豆 消耗 。 


SAE 本 地 开发 环境 集成 了 Apache、PHP、Redis 等 服务 ， 又 用 PHP 文 件 模拟 SAE 的 Storage、KVDB、FetchURL 等 服务 。 这 是 一 个 绿色 软件 ， 解 压缩 之 后 可 以 直接 运行 。 值 得 注意 的 是 ， 该 软件 没有 集成 
MySQL， 如 果 在 开发 应 用 时 用 到 ， 需 要 自行 配置 ; 该 软件 没有 可 视 化 界面 ， 只 有 命令 行 方式 。 目 前 版 本 为 1.3.0， 仪 支持 Windows 操 作 系统 。 


1. 下 载 与 环境 初始 化 


SAE 本 地 开发 环境 可 以 在 SAE 公 共 资 源 加 速 网 站 (http://lib.sinaapp.com/) 获取 ， 点 击 页 面 底部 的 “SAE Local Environment (Windows) ”链接 即 可 下 载 。 


下 载 到 本 地 的 文件 是 SAELocalEnvironment-windows-1.3.0.zip， 解 压缩 后 看 到 的 文件 目录 结构 如 下 : 





bin <DIR># 
可 执行 文件 / 
程序 目录 ，Apache 

*: .PHPB 

、Redis 

等 都 在 此 文件 夹 下 
emulation <DIR>t# 
环境 模拟 文件 ， 用 来 模仿 SAE 
环境 ， 包 括 FetchUzr1 
、Storage 

等 

















storag <DIR>#storage 
存储 目录 


tmp 
临时 目录 


WWWIOOt <DIR>t# 
根 目录 ， 网 站 代码 应 放 在 此 处 
changelog # 
变更 历史 
init.cmd 
环境 初始 化 脚本 
readme # 
帮助 文本 ， 介 绍 环境 的 常见 命令 
sae.conf #SAE 
配置 文件 ， 可 配置 Apache 
、Redis 

、MySOL 

等 参数 


tool .cmd 
本 地 模拟 环境 数据 清理 工具 


<DIR>t# 














#SAE 














#SAE 














运行 本 地 开发 环境 只 需要 执行 “init.cmd” 上 脚本 即 可 。 如 果 你 所 使 用 的 是 Windows XP 操作 系统 ， 请 确保 当前 登录 用 户 是 计算 机 管理 员 ; 如 果 为 Win7、Vista、Win8、Win8.1 等 ， 需 要 使 用 管理 员 身 份 
运行 ， 如 图 3-19 所 示 。 


打开 (O) 
\ 编辑 ( 


| Sae,cont 


站 打印 中 


定局 





图 3-19 


“Init.cmd” 脚 本 的 运行 场景 如 下 ， 可 以 看 到 启动 了 Apache 和 Redis 等 服务 。 当 Windows 命 令 行 界面 出 现 “LocalSAE>” 字 符 时 ， 就 表示 SAE 本 地 模拟 开发 环境 启动 成 功 ， 可 以 使 用 了 ， 如 图 3-20 所 


2. 常 用 应 用 管理 命令 


现在 我 们 要 创建 一 个 名 为 “demo” 的 应 用 ， 步 骤 大 致 为 : 创建 应 用 一 选择 或 切换 应 用 一 创建 版 本 一 更 新 配置 文件 (可 选 ) 。 


本 管理 员 : SAE 本 地 模拟 初始 化 工具 全 
AE 本 地 模拟 天 发 环境 止 在 局 动 -.. 


he SNE_Local fpache service is stopping . 
he es FT Apache sePFVy1Cce has stopped. 
三 到 apache 服 务 

eh 服 3 -=p 
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图 3-20 


(1) 创建 应 用 


命令 如 下 : 





LocalSAE> capp demo 
应 用 创建 成 功 





创建 成 功 后 ，wwwroot 目 录 下 自动 增加 了 一 个 名 为 “demo” 的 文件 夹 。 
(2) 选择 或 切换 应 用 


因为 可 能 同时 存在 多 个 应 用 ， 所 以 使 用 前 需要 切换 到 当前 开发 的 应 用 。 


LocalSAE> use demo 


已 切换 当前 应 用 

















如 果 想 查看 当前 选择 的 应 用 ， 可 以 用 sapp 命 令 。 





LocalSAE> sapp demo 


(3) 创建 版 本 


版 本 的 意义 在 于 你 的 应 用 可 以 同时 以 多 个 面目 存在 ， 推 出 新 版 本 时 又 需要 保留 旧版 ， 这 种 情况 下 多 版 本 就 很 有 必要 。SAE 最 多 允许 创建 10 个 版 本 ， 并 且 版 本 号 必须 为 正 整数 。 运 行 以 下 命令 : 





LocalSAE> cversion 1] 


创建 版 本 成 功 








在 你 的 应 用 目录 下 ， 会 添加 名 称 为 “1” 的 文件 夹 。 


还 可 以 设置 一 个 默认 版 本 ， 当 用 户 访问 时 ， 会 首先 呈现 默认 版 本 。 





LocalSAE> defver | 


设置 默认 版 本 成 功 











同时 可 以 查看 当前 默认 版 本 号 : 





LocalSAE> sversion 1] 





(4) 更 新 配置 文件 


由 于 你 的 操作 会 更 改 config.yaml 文 件 ， 完 成 以 上 步骤 后 ， 需 要 更 新 config.yaml 文 件 ， 保 证 你 的 操作 生效 。 


更 新 单个 版 本 的 配置 文件 : 











LocalSAE> upconfig 1 
config.yaml 


文件 更 新 成 功 











更 新 应 用 的 所 有 版 本 下 的 配置 文件 : 











LocalSAE> upallconfig 
demo 
应 用 的 config.yaml 
文件 更 新 成 功 




















至 此 ， 我 们 创建 了 一 个 名 为 “demo” 的 应 用 ， 默 认 版 本 号 为 1。 按 照 SAE 的 路 由 规则 ， 我 们 可 以 通过 demo.sinaapp.com 或 1.demo.sinaapp.com 访 问 刚才 创建 的 应 用 。 
要 在 本 地 访问 ， 是 否 要 配置 HOSTS? 


打开 HOSTS 文 件 (默认 位 置 在 C:\Windows\System32\drivers\etc\hosts， 如 果 没 有 请 查看 %Systemroot%\System32\drivers\etc\hosts， 其 中 %Systemroot% 指 系统 安装 路 径 ) ， 发 现 SAE 已 经 给 
配 好 了 。 





127.0.0.1 demo.sinaapp.com 127.0.0.1 1.qemo.sinaapp .com 





在 浏览 器 中 打开 1.demo.sinaapp.com 和 demo.sinaapp.com， 发 现 SAE 已 经 在 欢迎 我 们 了 ， 如 图 3-21 和 图 3-22 所 示 。 


mi 


' | demo.sinaapp.com 

















© SG& demo.sinaapp.com 


Yelcome to SAF! 





图 3-21 


i D1idemo.sinaapp.com 。 式 


1.demo.sinaapp.com 


elcome to SAE! 





图 3-22 


3.2.3 SAE 常 用 服务 


SAE 的 常用 服务 包括 云 计算 类 和 云 存储 类 ， 前 者 解决 程序 运行 问题 ， 后 者 解决 数据 存储 问题 。 
1.SAE 云 计算 类 服务 

云 计 算 有 两 个 重要 的 特点 : 

.分布 式 。 将 大 量 廉价 的 计算 机 通过 共享 网 络 (如 互联 网 ) 连接 起 来 ， 共 同 运行 程序 或 应 用 。 


* 弹性 计算 。 云 计算 提供 的 服务 应 该 能 根 据 用 户 的 资源 使 用 量 动态 调整 ， 而 用 户 只 需 为 自己 使 用 的 资源 付费 。 


为 此 SAE 提 供 了 多 种 云 计算 服务 来 满足 各 种 场景 业务 的 需求 。 

(1) Cron: 定时 服务 

Cron 服 务 是 SAE 为 开发 者 提供 的 分 布 式 定 时 服务 ， 用 来 定时 触发 开发 者 的 特定 动作 。Cron 的 应 用 场景 主要 是 让 用 户 可 以 在 指定 的 时 间 执 行 一 些 计划 任务 ， 可 以 分 为 两 类 : 
. 每 隔 一 定时 间 执 行 ， 例 如 每 30 分 钟 更 新 一 下 排行 榜 。 

. 在 某 个 特定 时 间 点 执行 ， 例 如 每 天 0 点 备份 数据 库 。 

(2) Image: 图 像 处 理 服务 


Image 是 SAE 为 开发 者 提供 的 分 布 式 图 像 处 理 服 务 ， 用 来 同步 地 对 图 片 进 行 CPU 密集 型 操作 。1Image 服 务 封装 了 一 些 常见 的 图 像 处 理 方法 ， 包 括 缩放 、 水 平 翻转 、 垂 直 翻 转 、 裁 剪 和 添加 文字 /图 片 水 印 
， 可 以 满足 一 般 需 要 。 


由 


(3) FetchURL: 网 页 抓 取 服 务 

FetchURL 是 SAE 为 开发 者 提供 的 分 布 式 网 页 抓 取 服务 ， 用 来 同步 抓 取 http 页 面 。 

FetchURL 主 要 用 于 发 起 http 请 求 ， 包 括 get 和 post， 并 且 支 持 https 和 重 定向 。 

(4) Mail: 邮件 发 送 服务 

Mail 是 SAE 为 开发 者 提供 的 分 布 式 邮 件 发 送 服务 ， 用 来 异步 发 送 标准 SMTP 邮 件 。Mail 常 见 的 应 用 场景 是 注册 账号 时 发 送 确认 邮件 、 发 送 订 阅 内 容 等 。 
(5) TaskQueue: 任务 队列 服务 


TaskQueue 是 SAE 为 开发 者 提供 的 分 布 式 任务 队列 服务 ， 用 来 以 异步 HTTP 方 式 执行 用 户 任务 。SAE 提 供 了 顺序 队列 和 并 发 队列 ， 顺 序 队 列 的 任务 顺序 执行 ， 而 并 发 队列 中 的 任务 则 以 并 行 的 方式 执行 。 
对 于 没有 数据 关联 的 任务 ， 可 以 使 用 并 发 队列 来 批量 处 理 。 


(6) DeferredJob: 离线 任务 服务 


DeferredjJob 是 SAE 为 开发 者 提供 的 分 布 式 重量 级 的 长 时 间 离 线 任务 执行 队列 。DeferredjJob 通 常用 于 没有 截止 时 间 限 制 、 数 据 量 大 并 且 运 行 时 间 较 长 的 任务 ， 例 如 用 户 的 数据 库 大 文件 导入 /导出 、 数 
据 库 批量 操作 等 。 同 样 是 任务 队列 ，DeferredJob 与 TaskQueue 差 别 很 大 ， 这 里 做 一 个 比较 ， 如 下 表 所 示 。 


执行 方式 HTTP 和 触发 系统 级 语言 执行 


执行 时 机 加 入 队列 即 执行 般 在 次 日 姿 晨 1 点 到 7 点 之 加 
限 籁 所 有 队列 总 数 不 超过 (包括) 10, 任务 总 数 不 限 每 天 最 多 10 个 任务 





(7) Channel: 实时 消息 推送 服务 


channel 是 SAE 为 开发 者 提供 的 实时 消息 推送 服务 ， 用 来 支持 实时 性 较 高 的 应 用 ， 如 游戏 、 在 线 聊 天 室 、 在 线 直 播 等 。Channel 服 务 在 2014 年 2 月 14 日 正式 对 外 开放 。 


2.SAE 云 存储 类 服务 
云 存储 是 与 云 计算 密切 相关 的 一 个 重要 研究 方向 。 与 云 计 算 一 样 ， 优 秀 的 云 存 储 平台 需要 具备 以 下 几 个 条 件 : 
“ 安全 。 这 是 云 存 储 的 首要 要 求 。 数 据 不 能 被 授权 之 外 的 人 或 机 器 窃取 ， 并 且 保 证 数据 完整 。 
透明 化 。 当 用 户 通 过 云 存 储 平台 读 取 或 存放 数据 时 ， 只 须 通 过 平台 提供 的 接口 去 读 写 ， 无须 关心 数据 存储 在 哪 块 物理 磁盘 ， 也 无 须 担 心 物理 磁盘 是 否 已 满 等 。 
` 按 需 分 配 。 用 户 只 为 自己 使 用 的 服务 付费 。 举 例 来 说 ， 某 用 户 存储 数据 用 了 20M 空 间 ， 那 他 只 用 支付 20M 空 间 的 钱 ， 肯 定 不 会 花费 一 个 磁盘 的 钱 。 


. 动态 服务 。 动 态 意味 着 可 扩展 。 例 如 ， 一 个 刚 上 线 的 产品 ， 前 期 访问 人 数 较 少 ， 这 时 所 需 的 云 计 算 和 云 存 储 资源 也 较 少 ; 某 一 天 ， 运 营 人 员 发 起 了 一 个 给 力 的 营销 活动 ， 访 问 人 数 暴 增 。 这 时 平台 需 
要 有 可 扩展 性 ， 来 应 对 突如其来 的 流量 。 


作为 优秀 的 应 用 引 警 ，SAE 提 供 了 多 种 云 存 储 类 服务 ， 包 括 MySQL、Storage、Memcache、KVDB、Counter 和 Rank， 对 企业 用 户 还 提供 CDN 服 务 。 


图 3-23 是 SAE 云 存储 类 服务 的 结构 图 。 从 是 否 为 关系 型 数据 库 来 分 类 ， 云 存储 类 服务 可 分 为 关系 型 数据 库 和 非 关 系 型 数据 库 。 从 严格 意义 来 说 ，Memcache、Counter 和 Rank 不 算是 数据 库 。 
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图 3-23 
SAE 上 的 关系 型 数据 库 是 MySQL。SAE 上 的 MySQL 服 务 和 普通 MySQL 服 务 几 平一 样 ， 所 以 你 可 以 按照 常规 的 MySQL 使 用 方法 来 使 用 。 


非 关系 型 数据 库 即 近年 来 得 到 广泛 关注 和 发 展 的 NoSQL。NoSQL 是 Not Only SQL 的 简写 ， 意 为 “不 仅仅 是 SQL”。 它 不 是 单纯 地 反对 关系 型 数据 库 ， 而 是 强调 根据 应 用 所 需 业务 的 不 同 ， 灵 活 地 采用 
键 值 、 文 档 、 图 形 关系 等 数据 库 的 优点 ， 来 达到 高 并 发 (High Performance) 、 大 存储 (Huge Storage) 、 高 可 扩展 性 和 高 可 用 性 (High Scalability & High Availability) 的 目的 。 下 面 对 SAE 的 几 个 非 
关系 型 数据 库 做 一 个 简介 ， 详 细 分 析 见 后 续 各 章节 。 


storage 属 于 文档 型 数据 库 ， 从 SAE 早 期 文档 中 可 以 看 到 ， 其 存储 系统 采用 著名 的 文档 型 数据 库 MongoDB 的 GFs 文 件 存储 (MongoGFS) 。Storage 为 开发 者 提供 分 布 式 文件 存储 服务 ， 用 来 存放 用 户 
的 持久 化 存储 的 文件 ， 例 如 用 户 上 传 的 图 片 、 附 件 等 。 


KVDB 属 于 键 值 型 数据 库 ， 类 似 于 Redis， 提 供 分 布 式 键 值 数 据 存 储 服务 。 据 SAE 文 档 所 述 ，KVDB 对 每 个 用 户 可 支持 100G 的 存储 空间 ， 可 支持 10 亿 条 记录 ， 并 且 高 性 能 高 可 靠 , 读 写 可 达 10w qps。 
Memcache 为 开发 者 提供 分 布 式 缓存 服务 ， 主 要 用 于 缓存 程序 中 经 党 读 取 又 在 一 段 时 间 内 不 变 的 数据 ， 其 使 用 与 标准 的 Memcache 一 致 。 


Counter 为 开发 者 提供 计数 器 服务 。 例 如 中 国 好 声音 网 上 投票 ， 每 秒 钟 有 数 以 万 计 的 人 参与 ， 这 时 要 求 云 存储 具有 在 高 并 发 情景 下 处 理 计数 的 能 力 。Counter 简 化 了 计数 应 用 的 开发 ， 通 过 API 即 可 对 计 
数 器 进行 加 减 操 作 ， 得 到 统计 结果 。 


Rank 是 为 开发 者 提供 的 分 布 式 环境 下 的 排行 榜 服 务 ， 其 特点 是 快速 可 靠 ， 可 以 用 于 实时 环境 。 利 用 Rank 服 务 可 以 轻松 地 实现 热门 文章 排行 、 用 户 活跃 度 排 行 等 。 


3.3 ”BAE 环 境 搭建 


BAE (Baidu App Engine) 是 百度 公司 (baidu.com) 推出 的 云 应 用 引擎 ， 支 持 的 语言 环境 包括 PHP、Java、Python、Node.js、static 等 ， 最 新 版 本 为 3.0。 
说 到 BAE， 不 得 不 说 一 下 2.0 到 3.0 的 “巨变 ”。 


开发 者 在 使 用 BAE 2.0 的 过 程 中 ， 会 发 现 很 多 功能 受到 限制 ， 最 大 的 障碍 在 于 禁止 本 地 写 操作 。 有 一 些 著 名 的 CMS 或 博客 系统 ， 它 们 的 安装 过 程 通 常 要 求 配置 文件 是 可 写 的 ， 但 BAE 2.0 茶 止 本 地 写 操 
作 ， 叶 致 安装 不 了 ; 另外 有 些 系统 有 cache 缓 存 目 录 ， 要 求 该 目录 可 读 写 ， 但 在 BAE 2.0 上 实现 不 了 。 本 地 开发 环境 和 云端 环境 不 一 致 ， 开 发 者 不 得 不 针对 BAE 做 相应 的 修改 ， 于 是 就 出 现 了 WordPress for 
BAE 等 类 似 的 移植 版 本 。 


这 个 问题 的 主要 原因 在 于 传统 PaaS (例如 BAE 2.0 等 ) 采用 “ 沙 盒 技术 ”来 实现 应 用 之 间 的 资源 隔离 ，“ 沙 盒 技术 ”需要 对 运行 环境 和 编程 语言 进行 功能 限制 〈 例 如 禁止 创建 进程 和 线程 ， 禁 止 某 些 系 
统 调用 ， 禁 止 对 某 些 文件 系统 路 径 的 读 写 ， 禁 止 加 载 C 语 言 模块 ， 禁 止 某 些 网 络 功能 等 ) ， 这 就 大 大 增加 了 开发 者 的 学 习 成 本 ， 也 使 得 应 用 的 开发 和 迁移 难度 变 大 。 


为 了 解决 这 个 困扰 广大 开发 者 的 问题 ， 百 度 推出 了 BAE 3.0。BAE 3.0 在 底层 采用 的 “ 轻 量 虚拟 机 技术 ”完美 解决 了 资源 隔离 问题 ， 而 在 运行 环境 和 编程 语言 层面 ， 则 不 做 任何 限制 ， 应 用 在 云端 的 运行 
环境 与 开发 者 本 地 的 开发 环境 保持 一 致 ， 从 而 使 得 学 习 成 本 、 开 发 和 迁移 成 本 降 到 最 低 ， 开 发 者 的 生产 力 得 到 最 大 限度 解放 。 


这 里 介绍 BAE 的 几 个 基本 概念 : 
. 执行 环境 ; 云 环 境 中 应 用 程序 执行 的 环境 。 执 行 环境 由 执行 组 组 成 ， 每 个 执行 组 包含 执行 单元 。 执 行 环境 分 为 公共 集群 和 私有 集群 。 


“ 执行 单元 : 执行 单元 是 云 环境 里 面 运行 用 户 代 码 的 最 小 服务 实例 。 


* 执行 组 : 若干 执行 单元 组 成 的 集合 。 同 一 个 执行 组 内 的 不 同 执行 单元 的 环境 是 同 构 的 。 执 行 组 内 执行 单元 个 数 会 根据 实际 负载 自动 调整 ， 但 会 受到 系统 阅 值 的 限制 或 用 户 配额 的 限制 。 
` 公共 集群 : 指 属 于 云 环境 系统 的 执行 组 的 集合 。 云 环境 会 保证 公共 集群 里 面 不 同 用 户 不 同 应 用 之 间 代 码 和 数据 的 安全 隔离 。 公 有 集群 对 用 户 来 说 是 完全 透明 的 。 


* 私有 集群 : 完全 属于 用 户 自己 的 执行 组 的 集合 。 用 户 可 以 选择 自己 应 用 的 代码 部 署 到 自己 拥有 的 任意 执行 组 内 。 私 有 执行 组 内 的 执行 单元 不 会 和 其 他 用 户 共享 。 


3.3.1 创建 工程 


BAE 采 用 百度 通行 证 登录 ， 如 果 你 还 没有 ， 请 到 百度 网 站 注册 通行 证 ( 见 图 3-24) 。 


作 " @ developer.baidu.com 
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图 3-24 
下 面 是 创建 一 个 工程 的 步 又。 
1) 进入 百度 开放 云 平台 (http://developer.baidu.com/) ， 点 击 页 面 右上 角 的 “登录 ”， 在 弹出 的 界面 中 登录 。 


2) 在 顶部 导航 处 点 击 “ 开 发 者 服务 管理 ”， 在 弹出 菜单 中 选择 “开发 者 服务 管理 ”， 进 入 已 创建 的 工程 列表 ( 见 图 3-25) 。 或 者 直接 输入 开发 者 服务 管理 的 网 址 : 
http://developer.baidu.com/console#appVproject。 








图 3-25 


3) 点 击 “ 创 建 工 程 ”按钮 ， 勾 选 “ 解 决 方案 ”的 “使 用 BAE” ， 会 出 现 完 整 的 选项 。 注 意 ， 如 果 需 要 PHP 环 境 ，“ 类 型 ”应 该 选择 php-web; 域名 一 经 创建 ， 不 能 更 改 ， 请 慎重 填写 ( 见 图 3-26) 。 


确认 信息 填写 完整 后 ， 点 击 “ 创 建 ”按钮 ， 就 完成 了 工程 创建 。 


《| 创建 工程 
* 应 用 名 称 : 


伟 琉 接 六 打 展 : | 合作 网 站 


解决 万 其 : 使 用 BAE 


六 域名 : walxinprojJectl100 . duapp. com 


代码 版 本 工具 : 





图 3-20 


4) 在 开发 者 服务 管理 页 面 点 击 刚才 创建 的 “ 微 信 开 发 ”工程 ， 进 入 该 工程 的 详细 信息 页 。 左 边栏 是 可 用 的 服务 ， 点 击 项 目 可 进入 相应 的 设置 页 ， 如 图 3-27 所 示 。 


ID : 2370776 


EN Frontia 


API 及 BT: DYwOPhl jadklIxXa3lfCckedy 

Secret Eey: UIIjZU?T?SX5Hepegi4LfD02BS8KqbZHFC4 | 重 宦 
创建 时 间 : 2014-03-15 01:25:46 

更 新 时 间 : 2014-03-15 01:31:28 





图 3-27 
5) 点 击 左边 栏 的 “应 用 引擎 ”， 可 以 看 到 已 创建 的 执行 单元 。 点 击 “SVNV/GIT 地 址 ” 栏 下 的 “点 击 复制 ” ， 可 以 得 到 仓库 地 址 。 仓 库 的 登录 账号 为 BAE 账 号 ， 如 图 3-28 所 示 。 


至 此 ，BAE 环 境 已 经 创建 好 ， 可 以 进行 开发 了 。 


部 署 列表 | 扩展 服务 | 配额 管理 


十 添加 部 轩 | 四 管理 执行 单元 | 发 发 布设 置 | 目 查看 日 志 | 山 资源 监控 | | 亩 删除 





[| | 名 称 资源 数 + | 578/GIT 地 址 | 状态 


[ Telxlnprolectli00 点 击 查 看 php—web 点 击 复 制 | @ 正常 





图 3-28 


3.3.2 ”BAE 常 用 服务 

BAE 的 常用 服务 包括 Cache (缓存 ) 、Image (图 片 处 理 ) 、MySQL (数据 库 ) 、Redis (数据 库 ) 、MongoDB (数据 库 ) 、Cron (定时 任务 ) 、FetchURL (网 页 抓 取 ) 、TaskQueue (任务 队 
列 ) 等 。 下 面 分 别 对 这 些 常用 服务 进行 介绍 。 

Cache (缓存 ) : 是 一 个 内 存 对 象 缓 存 服务 ， 使 用 接口 和 Memcache 相 似 。 将 短期 内 需要 集中 访问 的 数据 放 在 内 存 中 ， 从 内 存 中 读 取 ， 从 而 减少 数据 库 访 问 次 数 ， 提 高 读 取 速 度 。 


.Image (图 片 处 理 ) : BAEB 提 供 的 lmage 服 务 功能 很 强大 ， 除 了 基本 的 图 片 处 理 (裁剪 、 缩 放 、 旋 转 、 合 成 ) 外 ， 还 提供 了 二 维 码 、 文 字 水 印 、 验 证 码 等 功能 。 只 需 很 少 的 代码 ， 就 能 实现 基本 的 图 片 
处 理 。 


.MySQL (数据 库 ) : 提供 MySQL 数 据 库 服务 ,功能 和 和 MySQL 完全 一 致 。 
. Redis (数据 库 ) : 键 值 型 NoSQL 数 据 库 服务 。 服 务 器 端 采用 Redis (http://redis.io/) 。 


. MongoDB (数据 库 ) : 是 一 个 分 布 式 NoSQL 数 据 库 服 务 。 服 务 器 端 采 用 著名 的 文档 型 数据 库 MongoDB (http://www.mongodb.org) ， 使 用 方式 和 标准 MongoDB 完 全 一 致 ， 并 且 支持 各 种 语言 原生 的 


SDK 访 问 数据 库 。 


“ Cron (定时 任务 ) 、FetchURL (网 页 抓 取 ) 、TaskQueue (任务 队列 ) 分 别提 供 定时 任务 、 网 页 抓 取 、 任 务 队 列 服务 ， 不 再 更 述 。 


3.4 开 上 友 第 一 个 应 用 


当 你 决定 进入 微 信 公众 平台 开发 时 ， 有 件 最 重要 的 事情 摆 人 在 你 面前 : 申请 公众 账号 和 相关 接口 。 在 等 待 微 信 官方 审核 的 过 程 中 ， 我 们 可 以 利用 微 信 公众 平台 提供 的 测试 账号 进行 开发 。 


3.4.1 下 载 PHP SDK 


蔬 


微 信 公众 平台 提供 了 多 个 接口 ， 网 上 也 有 很 多 开源 的 微 信 公 众 平台 PHP SDK。 作 为 一 个 开发 者 ， “重复 造 轮子 ”实现 所 有 接口 ， 不 是 一 个 明智 之 举 。 最 好 根据 自身 的 用 途 (是 否 商用 、 是 否 再 分 发 ) 来 


选择 一 个 合适 的 开源 软件 。 这 里 推荐 几 个 : 


“ https://github.com/spetaculat/weixin 本 书 作者 开发 的 SDK， 采 用 MIT License 
* https://github.com/zemzheng/ WeChatPHP-SDK 采 用 MIT License 
* https://github.com/dodgepudding/wechat-php-sdk 采 用 GNU LGPL vetsion 2.1 License 


本 书 中 采用 第 一 个 SDK。 如 果 你 的 电脑 上 装 有 Git， 可 以 克隆 一 份 : 





git clone https://github.com/spetacular/weixin.git 





或 者 点 击 项 目 主 页 右 下 角 的 “Download Zip” 和 直接 下 载 ， 下 载 地 址 为 : https://github.com/spetacular/weixin/archive/master.zip。 


解压 后 的 代码 结构 如 下 : 








README .md 
使 用 说 明 

api .php 
公众 平台 消息 接 
defaultweixin.php 
扩展 逻辑 实现 
weixin.class.php 
微 信 接口 实现 类 
weixin.config.php 
微 信 配置 文件 














DO 









































Fl EYA ye 全 | 演 国 了 测试 工 | 号 十 请 


到 


微 信 公 众 平台 提供 了 测试 账号 ， 在 公众 账号 没 审核 通过 之 前 ， 也 能 进行 开发 ， 网 址 如 下 http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login。 


进入 登录 界面 ， 会 看 到 如 图 3-29 所 示 的 页 面 。 


微 信 公众 平台 接口 测试 帐号 申请 


无 需 公 众 帐号 、 快 速 申 请 接口 出 试 号 
直接 体验 和 测试 公众 平台 所 有 高 级 接口 


微 信 帐号 注册 /登录 于 机 帐号 登录 


未 注册 用 户 或 蓉 信和 与 注册 用 户 请 扫 搓 以 下 一 稚 信 进行 注册 / 登 水 已 注册 手机 帐 三 用 户 请 输入 以 下 信息 进行 登录 


手机 获取 验证 码 
用 于 获取 验 让 


短信 和 验证 码 





图 3-29 


左边 是 一 个 二 维 码 ， 用 微 信 “ 扫 一 扫 ” 功 能 扫描 后 会 自动 登录 。 如 果 页 面 放置 一 段 时 间 后 再 去 登录 ， 微 信 扫 一 扫 后 出 现 错 误 页 面 ( 见 图 3-30) 。 





图 3-30 
这 是 因为 这 个 二 维 码 是 带 时 间 参 数 的 临时 二 维 码 ， 过 期 后 会 失效 ， 第 8 章 会 详细 说 明 如 何 实现 。 


图 3-29 右 侧 提 供 了 手机 短信 验证 码 的 登录 方式 ， 不 再 歼 述 。 


登录 后 出 现 测试 号 的 管理 页 ( 见 图 3-31) 。 这 里 重要 的 信息 是 测试 号 信息 中 的 applD 和 appsecret， 访 问 接口 时 需要 用 到 。 接 口 配置 信息 中 的 URL 是 你 的 服务 器 地 址 中 公众 平台 消息 接口 的 网 址 ，Token 
是 你 与 微 信 服务 器 约定 的 一 个 密码 。 





管理 测试 号 微 信号 ; gh_ea3611b94a80 ”退出 


Wy 请 注意 ， 该 测试 号 将 于 2015-03-07 失 效 


测试 号 信息 
applD 


appsecret 


接口 配置 信息 修改 


请 填写 接口 配置 信息 ， 此 信息 需要 你 有 自己 的 服务 器 资源 ， 填写 的 URL 需 要 正确 响应 微 信 发 送 的 Token 验 证 ， 请 阅读 消息 接 
口 使 用 指南 。 


URL 





图 3-31 


3.4.3 ”上 传 服务 器 


在 上 传 服务 器 之 前 ， 需 要 修改 weixin.config.php 里 的 配置 项 ， 包 括 applD、appsecret 和 Token， 如 下 代码 所 示 。 





<?php define('APPID', 'APPID');// 
这 里 的 APPII 
替换 为 你 的 appID define ('APPSECRET', 'APPSECRET');// 
这 里 的 APPSECRET 
替换 为 你 的 appsecret define ('TOKEN', 'Token');// 
这 里 的 TOKEN 
请 与 接口 配置 信息 里 的 Token 
保持 一 致 ?> 














J 






























































将 代码 上 传 到 服务 器 。 这 时 ， 如 果 api.php 的 网 址 是 “http://www.example.com/api.php”， 那 么 测试 管理 页 的 URL 就 填写 为 “http://www.example.com/api.php” ( 见 图 3-32) 。 


请 填 与 接口 配置 信息 ,此 信息 需要 你 有 上 自己 的 服务 名 资源 ,填写 的 URL 需 要 正 确 响 应 徽 信 发送 的 Token 验 证 ,请 阅读 消息 接 
口 使 用 指南 。 


URL http://www.example.com/api.php 


Token | token | 
























































图 3-32 


点 击 “ 提 交 ” 按 钮 ， 微 信服 务 器 会 自动 验证 接口 及 签名 是 否 正 确 。 验 证 过 程 就 像 装 电脑 主机 时 连 各 种 各 样 的 线 ， 能 连 上 就 是 正确 。 正 确 的 话 ， 修 改 生效 ， 茶 喜 ， 你 已 接 入 开发 者 模式 了 。 如 果 提示 配置 
失败 ， 请 检查 各 个 配置 项 是 否 正确 。 


3.4.4 扫 摘 二 维 码 


扫描 测试 公众 号 的 二 维 码 ， 并 关注 ， 就 能 在 管理 测试 页 看 到 用 户 列表 ( 见 图 3-33) 。 





测试 号 二 维 码 
用 户 列表 (最 多 20 个 ) 
序号 | 昵称 微 信号 
1 david oRV6Mt8WfWWFkGdy oonqMjDfGoIQ 
请 用 微 信 扫 措 关 注 测试 公众 号 
图 3-33 


PHP SDK 默 认 的 用 户 消息 处 理 方 法 是 返回 用 户 发 送 的 信息 ， 即 “ 鹦 圳 学 和 天” ， 效 果 如 图 3-34 所 示 。 


操作 
移 除 


由 全 . 川 避 21:55 





和 ” 考 你 也 好 


干 嘛 学 我 说 话 ? 












































图 3-34 


至 此 ， 一 个 简单 的 应 用 完成 了 。 


第 4 草 ”消息 接口 API 


通过 第 3 章 的 介绍 ， 相 信 大 家 已 经 了 解 了 公共 平台 开发 的 流程 和 所 能 借助 的 各 种 工具 。 牛 刀 小 试 之 后 ， 接 下 来 为 大 家 详细 介绍 微 信 公共 平台 提供 给 我 们 的 各 种 接口 ， 它 们 可 以 让 我 们 在 开发 过 程 中 更 加 得 
心 应 手 。 


4.1 开 友 者 模式 接 入 


在 第 3 章 中 ， 我 们 已 经 配置 好 了 公众 号 的 接口 信息 。 需 要 提供 URL 和 Token， 其 中 URL 是 我 们 用 来 接受 微 信服 务 器 数据 的 接口 URL， 是 我 们 应 用 的 对 外 接口 ， 现 在 只 支持 80 端 口 ， 这 也 是 HTTP 协 议 默认 
的 端口 。Token 则 是 由 我 们 任意 填写 的 字符 串 ， 必 须 是 英文 字母 或 者 数字 ， 长 度 为 3~ 32 个 字符 。URL 很 好 理解 ，Token 有 什么 作用 呢 ” Token 相 当 于 我 们 提供 给 微 信 服务 器 的 信物 ， 我 们 通过 验证 来 访 的 请 
求 携带 的 信物 是 否 正确 就 能 判断 是 否 是 真 的 微 信 服务 器 而 不 是 冒名 顶替 者 。 


在 我 们 提交 URL 和 Token 信 息 后 ， 微 信服 务 器 将 发 送 GET 请 求 到 填写 的 URL 上 ，GET 请 求 携 带 四 个 参数 ( 见 下 表 ) 。 


微 信 加 密 签 名 ，signature 结 合 了 开发 者 填写 的 token 参 数 和 请 求 中 的 timestamp 参 数 、nonce 
signature 
参数 
timestamp H 轩 间 ] 鹤 
nonce 随机 交 
echostr 随机 字符 串 


signature 的 加 密 流程 也 比较 简单 

1) 将 token、tmestamp、nonce 三 个 参数 进行 字典 序 排 序 。 至 于 字典 序 是 什么 ， 大 家 可 以 “ 必 应 ”下 ， 因 为 php 的 排序 函数 默认 采用 字典 序 ， 这 里 就 不 展开 介绍 了 。 
2) 将 排 好 序 的 三 个 参数 字符 串 拼 接 成 一 个 字符 串 并 进行 sha1 加 密 ， 这 个 加 密 的 结果 就 是 微 信 服务 器 发 给 我 们 的 数字 签名 了 。 

下 面 我 们 就 来 实现 如 何 验证 URL 来 源 是 否 可 靠 。 


$GET 是 php 的 全 局 数组 变量 ， 存 储 了 GET 请 求 携带 的 变量 名 称 和 值 ， 通 过 该 变量 我 们 就 能 获取 微 信 服务 器 所 发 请 求 中 携带 的 signature、timestamp、nonce 和 echostr 值 。 








来 源 是 兴 正 确 


* Qreturn boolean 











private function checkSignature () 
{ 
// 
获取 参数 值 
$signature = $ GET['signature']; 
$timestamp = $ GET['timestamp']; 
ne = $ GET['nonce']; 


护照 字 与 序 排序 将 所 个 参数 排序 


$params = array ($this-> token, $timestamp, $nonce); 
sort (Sparams， SORT STRING); 


// 
i 
0 密 









































$sig = shal (implode (Sparams) ) ; 
// 
判断 获得 的 签名 是 否 与 本 地 计算 的 相同 


return EE = $signature; 
} 


爹 查 签名 ， 如 果 正 确 ， 将 微 信 服务 器 请 求 中 的 echostr 字 段 原样 返回 。 








private function Sourcecheck () 








P- 


f (Sthis->checkSignature()) 1 
$echostr = $ GET['echostr']; 
echo $echostr; 

}elselt 

throw new Exception('" 


签名 不 正确 ')，; 
} 


























exit (0); 





验证 URL 有 效 性 成 功 后 即 接 入 生效 ,成 为 开发 者 ， 此 后 用 户 每 次 向 公众 号 发 送 消息 ， 或 者 产生 自 定义 菜单 点 击 事件 时 ， 都 将 推送 响应 URL。 


4.2 ”基础 支持 


4.2.1 ”申请 测试 账号 


在 第 1 章 中 提 到 微 信 公众 号 有 订阅 号 和 服务 号 之 分 ， 服 务 号 审核 较为 严格 ， 但 提供 的 接口 也 更 为 丰富 ， 作 为 开发 者 可 能 手头 上 并 没有 服务 号 可 以 使 用 ， 或 者 直接 拿 服务 号 来 做 开发 测试 页 较为 不 受 ， 会 影 


响 订 阅 者 的 体验 。 微 信 公 众 平台 给 开发 者 提供 了 测试 账号 ， 让 开发 者 能 尽情 体验 各 种 接口 的 实际 效果 。 


在 “功能 ”一 “高 级 功能 ”一 “开发 模式 ”页 面 ， 点 击 “ 申 请 测试 账号 ”按钮 ， 打 开 申 请 页 面 ， 如 下 图 所 示 : 


微 信 帐号 注册 /登录 手机 帐号 登录 
未 注册 用 户 或 向 信号 注册 用 户 请 扫描 以 下 二 维 码 进行 注册 /登录 已 注册 手机 帐号 用 户 请 输入 以 下 信息 进行 登录 


a | | 


用 于 获取 答 让 俯 ， 请 如 实 填 与 



































可 以 选择 微 信 账 号 登录 或 者 手机 账号 登录 。 这 里 我 们 选择 用 自己 的 微 信 账 号 扫描 二 维 码 的 方式 来 登录 ， 如 下 图 所 示 。 


请 注意 ， 该 测试 号 将 于 2015-03-07 失 效 





出 | 证 写 传 息 
wxed34ef44db810ele 


applD 
3998bf762f987997d6374e358eb0c636 





appsecret 
































































































































是 境 习 榨 [ 记 如 信 息 ，, 山 济 尽 圳 要 你 有 日 品 的 服务 句 交 法 ， 塘 写 的 URL 韦 要 正确 哆 应 依 全 吉 送 的 Token 输 uf， 请 由 庚 峭 忆 渡 


口 局 用 扎 南 。 
URL hitpy7ghuoyaaaoctu.sinaapp.comyapiphp 
Token David 1234956 


测试 号 一 和 锥 码 
用 户 列表 ( 录 寺 20 个 ) 
包 称 洁 信 号 操作 


夺 三 





硬 用 短信 扫 舞 六 入 Wolaj 写 
测试 账号 有 一 年 的 使 用 期 ， 这 个 日 期 足够 我 们 开发 使 用 的 了 。 上 图 红 框 中 的 appID 是 每 个 公众 号 的 唯一 D，appSecret 是 对 应 的 密 钥 ， 上 默认 只 有 已 经 成 为 开发 者 的 服务 号 才 有 ， 有 了 它 我 们 才能 进行 一 
言 公众 号 提供 的 各 种 接口 了 。 


口 


些 接 口 访问 ， 这 个 在 后 面 会 介绍 。 按 照 第 3 章 介绍 的 方式 ， 配 置 好 接口 信息 。 扫 描 测 试 号 二 维 码 ， 关 注 我 们 的 测试 号 ， 就 可 以 正常 使 用 微 


旦 ]/ 
尽 


4.2 ”基础 支持 


4.2.1 ”申请 测试 账号 
服务 号 审核 较为 严格 ， 但 提供 的 接口 也 更 为 丰富 ， 作 为 开发 者 可 能 手头 上 并 没有 服务 号 可 以 使 用 ， 或 者 直接 拿 服 务 号 来 做 开发 测试 页 较为 不 受 ， 会 


在 第 1 章 中 提 到 微 信 公 众 号 有 订阅 号 和 服务 号 之 分 
响 订 阅 者 的 体验 。 微 信 公 众 平台 给 开发 者 提供 了 测试 账号 ， 让 开发 者 能 尽情 体验 各 种 接口 的 实际 效果 。 


高 级 功能 ”一 “开发 模式 ”页 面 ， 点 击 “ 申 请 测试 账号 ”按钮 ， 打 开 申 请 页 面 ， 如 下 图 所 示 : 


在 “功能 ” = “ 富 


微 信 帐号 注册 /登录 手机 帐号 登录 
未 注册 用 户 或 向 信号 注册 用 户 请 扫描 以 下 二 维 码 进行 注册 /登录 已 注册 手机 帐号 用 户 请 输入 以 下 信息 进行 登录 


a | | 


用 于 获取 答 让 俯 ， 请 如 实 填 与 



































可 以 选择 微 信 账 号 登录 或 者 手机 账号 登录 。 这 里 我 们 选择 用 自己 的 微 信 账 号 扫描 二 维 码 的 方式 来 登录 ， 如 下 图 所 示 。 








请 注意 ， 该 测试 号 将 于 2015-03-07 和 失效 





applD Wxed34cf44db81tele 





appsecret 33998bt/62f387997do3r4e358ebDcba6 


接口 名 得 信息 储 改 


是 境 习 榨 [ 记 如 信 息 ，, 山 济 尽 圳 要 你 有 日 品 的 服务 句 交 法 ， 塘 写 的 URL 韦 要 正确 哆 应 依 全 吉 送 的 Token 输 uf， 请 由 庚 峭 忆 渡 
品 司 用 损 丙 。 


URL hitps//8.huoyaxiaotu.sinaapp.com/api.php 


Token David 1234956 





用 户 列 表 【 量 完 20 个 ) 








一 本 一 





夺 三 蛇 称 阁 售 号 探 作 





请 用 向 信 扫 摘 关 计 交大 三 


测试 账号 有 一 年 的 使 用 期 ， 这 个 日 期 足够 我 们 开发 使 用 的 了 。 上 图 红 框 中 的 applD 是 每 个 公众 号 的 唯一 ID，appSecret 是 对 应 的 密 钥 ， 默 认 只 有 已 经 成 为 开发 者 的 服务 号 才 有 ， 有 了 它 我 们 才能 进行 一 
些 接口 访问 ， 这 个 在 后 面 会 介绍 。 按 照 第 3 章 介绍 的 方式 ， 配 置 好 接口 信息 。 扫 描 测试 号 二 维 码 ， 关 注 我 们 的 测试 号 ， 就 可 以 正常 使 用 微 信 公 众 号 提供 的 各 种 接口 了 。 


4.2.2 ”获取 access token 


access token 在 微 信 开发 中 有 着 非常 重要 的 作用 ， 它 相当 于 一 把 钥匙 ， 只 有 获得 这 个 值 ， 才 能 获得 其 他 接口 的 使 用 权限 。access token 是 公众 号 的 全 局 唯一 票据 ， 公 众 号 调用 各 接口 都 需要 使 用 
access token， 有 效 期 是 7200 秒 ， 重 复 获 取 将 导致 覆盖 上 次 获取 的 值 。 由 于 获取 access token 的 API 调 用 次 数 有 限 ， 建 议 全 局 人 存储 与 更 新 access token。 


获取 access token 的 接口 需要 使 用 appID 和 appsecret， 我 们 在 上 一 小 节 已 经 介绍 过 了 ， 只 有 服务 号 有 applD 和 appsecret， 订 阅 号 没有 ， 因 为 对 订阅 号 开放 的 接口 都 是 被 动 接口 ， 并 不 需要 这 个 。 


接口 调用 请 求 说 明 : 








汪汪 


Py i 


ttp 
4 求 方式 : GET 
tps://api.weixin.qq.com/cgi-bin/token?grant type=client credential&appid=APPID&secret=APPSECRET 


















































参数 说 明 ( 见 下 表 ) : 


参 数 是 否 必 须 说 明 
grant type 是 获取 access token 填 与 client credential 
appid 是 第 三 方 用 户 唯 一 凭证 
secret 是 第 三 方 用 户 唯 一 凭证 密 乌 ， 即 appsecret 


这 个 接口 的 调用 也 很 简单 ， 将 URL 中 的 applD 和 appSecret 葵 换 成 我 们 自己 申请 到 的 appID 和 appSecret， 使 用 GET 方 式 发 送 HTTP 请 求 。 注 意 到 调用 微 信 接 口 时 均 使 用 https 协 议 ， 这 样 保证 了 个 人 信息 
会 泄露. 


正常 情况 下 ， 微 信服 务 器 会 返回 下 述 JSON 数 据 包 给 公众 号 : 


{"access token" :"ACCESS TOKEN", "expires in":7200} 











JSON 数 据 包 的 参数 说 明 如 下 表 所 示 : 
参 数 说 明 
access_token 获取 到 的 开 证 
expires in 开 证 有 效 时 间 ， 单 位 : 秒 


错误 时 微 信 会 返回 错误 码 等 信息 ，JSON 数 据 包 示例 如 下 (该 示例 为 applD 无 效 错误 ) : 





{"errcode":40013, "errmsg":"invalid appid"} 





了 解 了 接口 的 基本 信息 ， 下 面 我 们 给 出 具体 的 代码 : 





const API URL = 'https://api.weixin.gq.com'; 
private static $access token; 
private static $expries time = 0; 



































于 获取 access_ token 
。 如 成 功 返 回 access_token 
， 失 败 返 回 false 

*)/ 


public static function getToken () { 


// 
如 果 已 经 获取 过 且 没 有 过 期 ， 直 接 返 回 
if(isset(self::$access token) && time() < self::S$expries time){ 
return self::$access token; 






































} 
$url=self::API URL."/cgi-bin/token?grant type=client credential&appid=".APPID."é&secret=".APPSECRET; 
$content=curl get ($url); 




































































// 
解析 成 JSON 
$ret=json decode ($content,true);//{"access token":"ACCESS TOKEN", "expires in":7200} 
if(array key exists('errcode',sret) && sretl[l'errcode'] != 0){ 
return false; 
}elsel{ 
self::S$access token = $ret['access token']; 
计算 过 期 时 间 
self::$expries time = time() + intval ($ret['expires in']); 

















return self::S$access token; 


函数 curl get (URL) 是 利用 cURL 库 实 现 GET 方 式 发 送 请 求 ， 获 取 数 据 ， 这 个 函数 我 们 以 后 会 经 常用 到 ， 由 于 本 书 主要 介绍 微 信 开发 ， 有 具体 的 php 函 数 这 里 就 不 做 具体 展开 了 ， 搜 索 一 下 就 能 知道 这 个 
消 数 的 用 法 : 





/** 


* GET 

方式 获取 服务 器 响应 
* Qparam {string} Surl 
* Qreturn {string|boolen 


} 
成 功 时 返回 服务 器 响应 内 容 ， 失 败 则 返回 false 
#1/ 




















function curl get( $url ){ 
$ch = curl init(); 
curl setopt ($ch, CURLOPT URL, $url);; 
curl setopt ($ch, CURLOPT RETURNTRANSFER, 1); 
curl setopt ($ch, CURLOPT SSL VERIFYPEER, FALSE); 
curl setopt ($ch, CURLOPT SSL VERIFYHOST, FALSE); 
if(!curl _ exec(S$ch) ) { 国光 
error log( curl error ( $ch )); 
$sdata = "''» 
} else { 
$data = curl multi getcontent ($ch); 


















































—— 
NA 


























} 
curl close (S$ch) ; 
return $data; 








4.3 ”接受 消息 


接受 消息 是 微 信服 务 器 发 送 给 公众 号 的 消息 ， 在 第 3 章 中 我 们 已 经 介绍 了 微 信服 务 器 的 数据 交换 方式 ， 当 订阅 用 户 给 微 信 公 众 号 发 送 消息 时 ， 微 信服 务 器 会 将 消息 封装 成 XML 数据 以 POST 方式 发 到 我 们 
配置 的 URL 上 。 根 据 消息 类 型 的 不 同 ，XML 数 据 的 格式 也 有 所 不 同 ， 下 面 我 们 将 详细 介绍 每 种 消息 格式 。 


4.3.1 文本 消息 


文本 消息 是 最 常 使 用 的 交互 方式 ， 任 何 发 送 的 文字 (包括 URL) 都 是 文本 消息 。 文 本 消息 的 结构 如 下 : 





<xml> 

<ToUserName><! [CDATA [toUser] 1></ToUserName> 
<FromUserName><! [CDATA [fromUser] ]></FromUserName> 
<CreateTime>1348831860</CreateTime> 
<MsgType><! [CDATA [text] ]></MsgType> 

<Content><! [CDATA[this is a test]]></Content> 
<MsgId>1234567890123456</MsgIgd> 





























</xm> 
具体 参数 如 下 表 所 示 : 
参 数 描 述 

ToUserName 消 且 接收 方 的 微 信和 号， 一般 为 公共 平台 账号 

FromUserName 消息 发 送 痢 的 openID 

CreateTime 消息 创建 时 间 ( 整 型 ) 

Msglype Text 

Content 文本 消息 内 容 

MsgId 消息 ID ，64 位 整 型 


表格 中 的 部 分 参数 详细 解释 如 下 : 

ToUserName: 微 信 公 众 号 的 原始 ID， 在 公众 号 的 账号 信息 里 能 看 到 ， 类 似 gh_****** 的 格式 ， 这 个 字段 对 公众 号 的 开发 者 而 言 没 什么 用 途 。 

FromUserName: 消息 发 送 者 的 OpenID。 类 似 0og17nt6kNCcqq25b77C8L2zEJXdQ 的 格式 。 对 同一 个 公众 号 ， 订 阅 用 户 的 OpenlD 是 固定 不 变 的 ， 而 对 于 不 同 的 公众 号 ， 用 户 的 OpenlD 是 不 同 的 。 
CreateTime: 消息 创建 的 时 间 ， 是 一 个 整 型 数字 ， 表 示 从 1970 年 1 月 1 日 0 时 0 分 0 秒 到 现在 经 过 的 秒 数 。 

MsgType: 消息 类 型 。 现 在 微 信服 务 器 提供 6 种 类 型 的 消息 : 文本 消息 (text) 、 图 片 消息 (image) 、 语 音 消 息 (voice) 、 视 频 消 息 (video) 、 地 理 位 置 消息 (location) 和 链接 消息 (link) 。 


下 面 我 们 给 出 具体 的 代码 ， 因 为 微 信 服务 器 是 以 POST 的 方式 将 数据 发 送 给 我 们 ， 所 以 首先 我 们 解析 POST 请 求 ， 提 取出 数据 ， 具 体 代码 如 下 : 


/** 
解析 接受 的 POST 
数据 





* Qreturn SimpleXMLElement 

加/ 
public function parsePostRequestData () 
{ 








SrawData = $GLOBALS['HTTP RAW POST DATA']; 























$data = simplexml load string (S$SrawData, 'SimpleXMLElement', LIBXML 
NOCDATA) ， 
if ($data !== false) 














Sthis-> postData = $data; 
return $data; 








从 $GLOBALS['HTTP_RAW_POST_DATA'] 从 $GLOBALS 全 局 变量 中 获取 POST 数 据 ， 这 时 得 到 的 数据 是 无 类 型 的 ， 我 们 通过 simplexml_load_string 冰 数 解析 成 XML 对 象 ， 就 能 供 后 续 使 用 了 。 


isTextMsg 用 于 判断 消息 的 类 型 ， 是 否 为 文本 消息 : 








const MSG TYPE TEXT = 'text'; 
/** 和 和 


* 
判断 是 否 为 文本 信息 
* Qreturn boolean 
*/ 
public function isTextMsg () 
{ 


} 
// 
发 送 消息 


Sthis->text (nm 
您 发 送 的 是 文本 消息 ， 消 息 内 容 是 :".Sqata->Content) ; 
































return S$this-> postData->MsgType ==— self::MSG TYPE TEXT; 











text 国 数 用 来 发 送 文 本 消息 ， 这 个 将 在 后 面 介绍 


车 Hi 





独 墅 湖 高 教区 




















= ee 











您 发 六 的 是 文本 消 恩 ， 滑 恩 内 容 是 
独 墅 湖 噩 教区 














4.3.2 图 片 消息 


图 片 消息 是 多 媒体 消息 ， 微 信 在 收 到 这 类 消息 时 ， 会 将 图 片 存在 微 信 服务 器 端 ， 生 成 图 片 的 URL 和 媒体 |D， 图 片 URL 是 可 以 公共 访问 的 ， 而 公众 号 则 可 以 通过 媒体 ID 来 获取 图 片 文件 。 图 片 消息 的 结构 
如 下 : 





<xml> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></EFromUserName> 
<CreateTime>1348831860</CreateTime> 

<MsgType><! [CDATA[image] ] ></MsgType> 

<PicUrl><! [CDATA [this is a url]l]></PicUr1l> 
<MediaId><! [CDATA [media iq] ] ></MediaId> 
<MsgId>1234567890123456</MsgIgd> 























</xml> 
具体 参数 如 下 表 所 示 : 
参 数 描述 
MSsgType limage 


PicUrl 图 片 链 接 
Mediald 图 片 消息 媒体 ID， 可 以 调用 多 媒体 文件 下 载 接口 拉 取 数据 


islmageMsg 用 于 判断 消息 的 类 型 是 否 为 图 片 消 息 : 














const MSG TYPE IMAGE="image'; 














/** 
汉 

判断 是 否 为 图 片 消息 
* Q@return boolean 
天/ 














public function 1sImageMsg (){ 
return Sthis-> postData->MsgType == self::MSG TYPE IMAGE 




















sthis->text (" 

您 发 送 的 是 图 片 消息 ， 

图 片 链接 是 : ".S$data->PicUrl."\n 
媒体 ID 
是 : ".S$Sdata-> MedialId); 

















图 片 月 息 , 图片 链 搜 是 : 
nitp in Im CP TT 
ImezHg zBGsellyilJLMAIGYyND 
ClbY RN aaaigiboioz LGEGIOI 








/Ll 

媒体 DD 是 : 
PXCcSs_ik8TPXzkymLR3NFviRpFO 
{- 
sNAaEidHknVCVPOGCkPpDHpasiO 
y31HIL 





En 


3 了 





4.3.3 “语音 消息 


语音 消息 一 样 只 发 送 媒体 ID， 语 音 消息 的 结构 如 下 。 


<xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></FromUserName> 
<CreateTime>1357290913</CreateTime> 
<MsgType><! [CDATA [voice] ]></MsgType> 

<Mediald><! [CDATA[media id]]></MediaId> 
<Format><! [CDATA [Format]1></Format> 
<MsgId>1234567890123456</MsgIgd> 

</xml> 




















具体 参数 如 下 表 所 示 : 


参 数 摘 述 
MsgType 省 痛 为 Voice 


Mediald 语音 消息 巡 体 ID ， 可 以 调用 多 媒体 文件 下 载 接口 拉 取 数据 
Format 语音 格式 ， 如 amr、speex 等 


isVoiceMsg 用 于 判断 消息 的 类 型 是 否 为 语音 消息 ; 











const MSG TYPE VOICE = 'voice';} 
/** Es - 
兢 


判断 是 否 为 语音 消息 
* Qreturn boolean 

















public function isVoiceMsg (){ 
return S$this-> postData->MsgType == self::MSG TYPE VOICE; 


























7 

发 送 消 息 
$sthis->text(" 
您 发 送 的 是 语音 消息 ， 


是 : ".$Sdata->MediaId."\n 
语音 格式 是 : ".S$Sdata-> Format)} 

















| 
| | | | 


| ‘ 伍 悟 必 庆 半 百 机 他 司 











你 发送 的 是 语音 消息 ,媒体 上 是 : 
PbopGSFpZz5ZBzrmE- 

WAU _ QiWapK9MSOEYrnagaLLAdEQ 
T_ SbEARVWAqLesUVOSJIAht 

语音 格式 是 : ami 











二 中 本 按 住 说 请 
mF 




















4.3.4 ”地 理 位 置 消息 


在 LBS 和 O2O 的 价值 被 极 大 发 掘 的 今天 ， 知 道 用 户 的 位 置 能 提供 很 多 有 针对 性 、 个 性 化 的 服务 。 微 信也 提供 了 在 输入 框 中 发 送 当前 位 置 的 功能 ， 见 下 图 : 





31 264877 

经 度 为 : 120.733204 
缩放 级 别 为 : 16 

位 置 为 人 头 玉 




















国 片 从 不 








地 理 位 置 消息 格式 如 下 : 


<xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></FromUserName> 
<CreateTime>1351776360</CreateTime> 

<MsgType><! [CDATA[location]]></MsgType> 

<Location X>23.134521</Location X> 

<Location Y>113.358803</Location Y> 
<Scale>20</Scale> 
<Label><! [CDATAT 
位 置信 息 ] ] ></Label> 
<MsgId>1234567890123456</MsgId> 
</xml> 






































具体 参数 如 下 表 所 示 : 


Msglype 
Location X 
Location Y 
Scale 


Label 


isLocationMsg 用 于 判断 消息 的 类 型 是 否 为 位 置 消息 : 


const MSG TYPE LOCATION = 'location'; 
/** 
2 


判断 是 否 为 位 置信 息 
* Q@return boolean 
x/ 
public function isLocationMsg () 
{ 
} 
// 
发 送 消息 
$sthis->text(" 
您 发 送 的 是 位 置 消息 ， 纬 度 为 : " .$data->Location X."\n 
经 度 为 : ". $data-> 一 
Location Y."\n 


缩放 级 别 为 : ".S$Sdata->Scale."\n 
位 置 为 : " .$data->Label); 





























return $this-> postData->MsgType == self: 
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location 

地 理 位 置 纬度 
地 理 位 置 经 度 
地 图 缩放 大 小 














技 园 


a Ee 


_“。“ 您 发 送 的 是 位 置 消 息 ,纬度 为 : 
31.2b5141 
经 度 为 : 120.733101 
缩放 级 别 为 : 16 
位 置 为 : 江苏 省 苏州 市 吴 中 区 


画 | 
画 和 
而 | | | 
画 





4.3.5 ”链接 消息 


这 里 的 链接 消息 与 URL 的 概念 有 所 不 同 ， 微 信 公 共 平 台 将 URL 作 为 文本 消息 。 那 么 怎么 友 送 链接 消息 呢 ? 打开 已 有 的 链接 (朋友 圈 或 者 朋友 发送 的 分 享 ) ， 点 击 右上 和 角 的 分 享 按钮 ， 选 择 “ 发 送 给 朋 


友 ”， 就 可 以 发 送 给 微 信 朋友 和 微 信 群 了 。 如 果 想 分 享 一 个 网 页 呢 ? 复制 URL， 粘 贴 到 消息 框 ， 发 送 给 微 信 朋 友 ， 建 议 发 送 给 公众 号 ， 免 得 打扰 别人 ， 打 开 链 接 ， 默 认 用 微 信 浏览 器 打开 ， 点 击 右上 角 的 分 


享 按钮 就 可 以 分 享 到 朋友 圈 或 者 发 送 给 朋友 了 。 当前 微 信 并 不 支持 发 送 链接 消息 给 公众 号 ， 如 果 想 发 送 ， 可 以 先 将 链接 收藏 到 收藏 夹 ， 然 后 在 消息 框 添加 “我 的 收藏 ”， 如 下 图 所 示 : 





Linkedln 高 级 分 析 师 王 益 : 大 
数据 时 代 的 理想 主义 和 现实 主 
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Mo.WelxINn.g99.corm 
s?_ Dliz=MzAd4MTEzNz 


和 | | 1 | | 让 mn | PE | i 
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我 的 收藏 





优生 创 量 相机 仇 伟 目 层 五 


链接 消息 的 格式 如 下 : 





<xml> 


<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ]></FromUserName> 
<CreateTime>1351776360</CreateTime> 





<MsgType>< 


<Title><! [CDATA[ 





! [CDATA[link]]1></MsgType> 





公众 平台 官网 链接 ] ] ></Title> 
<Description><! [CDATA[ 

公众 平台 官网 链接 ] ] ></Description> 
<Url><! [CDATA [ur1] 1></Ur1> 
<MsgId>1234567890123456</MsgIgd> 











</xml> 





具体 参数 如 下 所 示 : 


Msglype 
Title 


Description 


Lil 


isLinkMsg 用 于 判断 消息 的 类 型 是 否 为 链接 消息 : 





站 明 捅 述 
消 上 县 链接 

















const MSG TYPE LINK="'link'; 

















/** 
大 
判断 是 否 为 链接 消息 
* Qreturn boolean 
#7 
public function isLinkMsg(){ 
return $this-> postData->MsgType == self: 
} 
本 
发 送 消息 
Sthis->text (" 
您 发 送 的 是 链接 消息 ， 
标题 是 : ".$data->Title."\n 
摘要 是 : ".$gdata-> 


Description."\n 
链接 是 : ".S$Sqdqata->Ur1) ; 








:MSG TYPE LINK; 











利 ! 


四 





访 腾 ;去 抽 











中 二 中华 六 人 SN ， 
| 于 l Ee a 本 本 | [1 
ed | :| 
ny | | | |] = 有 ee 
i a | | | 虽 | 
中 靳 二 2 | 1 二 | : A UA 
lt ——— HT Ta i 
属 有 时 . | UD | -== 


您 发 送 的 是 链接 消息 ,标题 是 : 环 金鸡 

闻 双 六 会 ， 属 取 法 拉 午 

摘要 是. 竺 刘 春 化 烂 受 时 ， 一 起 来 薪 

行 14 月 19 日 ， 中 新 首 地 2014 周 年 庆 

收 下 大 戏 " 环 生 鸡 肖 贤 认 会 "和 始 

啦 !1048 

证 接 是 : http:// mp.weixin.qg.comy 

s?__Diz=MzA4Mz MxMDQZzNA=: 

d=2000850 5082&ldx= 3&snzf9a035dc 
eT9e3868b3br7re5d757b6b2fe#rd 





4.3.6 让 见 频 消息 


视频 消息 也 是 多 媒体 消息 ， 与 语音 消息 类 似 ， 格 式 如 下 : 








<xml> 








<ToUserName><! [CDATA [toUser] 1></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></EFromUserName> 
<CreateTime>1357290913</CreateTime> 

<MsgType><! [CDATA[video] ] ></MsgType> 

<MedialId><! [CDATA[media id]]></MediaId> 
<ThumbMediald><! [CDATA [thumb media idq] ] ></ThumpMedqiaId> 











<MsgId>1234567890123456</MsgI 





</xml> 


具体 参数 如 下 表 所 示 : 











Q> 


参 数 摘 述 


MsgType Vldeo 
MediaId 视频 消息 媒体 ID， 可 以 调用 多 媒体 文件 下 载 接口 拉 取 数据 
ThumbMediaId 视频 消 县 缩 略 图 的 媒体 ID， 可 以 调用 多 媒体 文件 下 载 接口 拉 取 数据 


isVideoMsg 用 于 判断 消息 的 类 型 是 否 为 视频 消息 : 








const MSG TYPE VIDEO = 'video'; 
/** 














大 
判断 是 否 为 视频 消息 


* QQreturn boolean 








public function isVideoMsg (){ 
return Sthis-> postData->MsgType == self::MSG TYPE VIDEO; 


























发 送 消息 
sthis->text (" 
您 发 送 的 是 视频 消息 ， 











媒体 ID 

是 : ".S$Sdata->MedialId."\n 
缩 略 图 ID 

是 :".S$Sdata-> ThumbMedialId); 














您 发 送 的 是 视频 疹 乱 ,媒体 |D 是 : 
vdRQQ-GD2GzYo- 
HUpQS5_VOPp3wXxBnt9aVUAy7phTf 
8n-0ZROpLhlbnByHRXCqgYhu 


HH NI FE. 
ILUS8tgp3_zbloqKqmX5mNdWIUwJ8 
3YDrR20NrKpaErkAMerl GhPD7FUt 
tPQP1Nb9 





4.4 ”接收 事件 消息 


事件 消息 是 订阅 用 户 对 公众 号 执行 某 种 操作 触发 的 消息 。 微 信 公 共 平 台 支 持 6 种 事件 : 关注 /取消 关注 事件 、 扫 描 二 维 码 事件 、 上 报 地 理 位 置 事件 、 自 定义 菜单 事件 、 点 击 菜单 拉 取 消息 事件 、 点 击 菜单 
跳 转 链接 事件 。 下 面 详细 介绍 前 4 个 事件 。 


4.4.1 天 注 /取消 天 注 事件 
当 用 户 关注 和 取消 关注 公众 号 时 ， 微 信 会 把 这 个 事件 推送 到 开发 者 填写 的 URL。 方 便 开 发 者 给 用 户 发 送 欢迎 消息 或 者 做 账号 的 解 绑 。 
消息 格式 如 下 : 


<xml> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [EromUser] ]></FromUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><! [CDATA [event] ]></MsgType> 

<Event><! [CDATA[subscribe] ]></Event> 

</xml> 














参数 说 明 见 下 表 : 
参 数 拉 述 
Msglype 消息 类 型 ，event 


Event 事件 类 型 ，subscribe( 订 阅 )、unsubscribe( 取 消 订 阅 ) 


isSubscribeEvent 用 于 判断 消息 的 类 型 是 否 为 订阅 事件 : 






























































const EVENT TYPE SUBSCRIBE='subscribe ' 
const EVENT TYPE UNSUBSCRIBE='unsubscribe ' 
/** 











判断 是 否 为 订阅 事件 
* Qreturn boolean 
WA 
public function isSubscribeEvent () 


{ 


















































return $this-> postData->Event == self::EVENT TYPE SUBSCRIBE && 
$this-> postData->EventKey == ""; 








} 


/** 
汉 


判断 是 否 为 退 订 事件 
* Qreturn boolean 
*/ 
public function isUnsubscribeEvent () 


{ 





























return Sthis-> postData->Event == Self: :EVENT TYPE UNSUBSCRIPBE; 















































} 
$sthis->text(" 
订阅 事件 ， 订 阅 用 户 是 :" .$data->FromUserName); 








i 订阅 事 件 ，1J 辐 用 户 
是 :0g17nt6kNCcqq25b77C8L2zEJX 
dQ 


Ne 





4.4.2 “扫描 二 维 码 事件 


微 信 提 供 了 生成 二 维 码 的 功能 ， 赋 予 了 公众 号 更 多 的 含义 和 想象 空间 。 当 微 信 用 户 扫描 二 维 码 时 ， 微 信 公 共 平 台 可 能 会 推送 以 下 两 种 事件 : 


.如果 用 户 还 未 关注 公众 号 ， 则 用 户 可 以 先 关 注 公众 号 ， 关 注 后 微 信 会 将 带 场景 值 关 注 事件 推送 给 开发 者 。 如 果 用 户 不 关注 ， 自 然 不 会 推送 事件 。 


* 如 果 用 户 已 经 关注 公众 号 ， 则 微 信 会 将 带 场景 值 扫描 事件 推送 给 开发 者 。 
1) 用 户 未 关注 时 ， 进 行 关注 后 的 事件 推送 如 下 : 


<xml><ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [FromUser] 1></FromUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><! [CDATA [event] ]></MsgType> 

<Event><! [CDATA[subscribe] ]></Event> 
<EventKey><! [CDATA [drscene 123123]1></EventKey> 
<Ticket><! [CDATA[TICKET] ] ></Ticket> 
































</xml> 

参数 说 明 见 下 表 : 
参 数 摘 述 
Event 事件 类 型 ，subscribe 


EventKey 事件 KEY 值 ，grscene 为 前 级 ， 后 面 为 二 维 人 码 的 参数 值 


Ticket 二 维 公 的 ticket， 可 用 来 换取 二 维 公 图 片 


isSubscribeScanEvent 用 于 判断 消息 类 型 是 否 为 未 关注 用 户 扫描 二 维 码 事件 : 


/** 
判断 是 否 为 未 关注 用 户 扫描 二 维 码 事件 


* Q@Qreturn boolean 






























































public function isSubscribeScanEvent () 












































return Sthis-> postData->Event == self::EVENT TYPE SUBSCRIBE && 
$this-> postData->EventKey != ""; 




















$this->text (" 
未 订阅 用 户 扫 描 二 维 码 事件 ，Key 
人 


是 :".S$Sdata->Ticket); 




















IC 


nEORahiAAARAR RE i 





EYECLOL SAUNMYY 


Oi8Bvd2VpeGluLnFxLmNvbS9xLzcw 
enIGSW5sRUdCeFVMNnhoMKPIAAI 
Eum1SUwMECACAAA== 

















2) 用 户 已 关注 时 的 事件 推送 。 推 送 XML 数 据 包 示例 : 


<xml> 


<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [EromUser] ]></FromUserName> 
<CreateTime>123456789</CreateTime> 








<MsgType><! [CDATA [event] ]></MsgType> 
<Event><! [CDATA[SCAN] ] ></Event> 























<EventKey><! [CDATA[SCENE 














VALUE ] ]></EventKey> 


<Ticket><! [CDATA[TICKET] ] ></Ticket> 


</xml> 
参数 说 明 见 下 表 : 
参 
Event 


数 拉 述 


EventKey 事件 KEY 值 ， 是 一 个 32 位 无 符号 整数 ， 即 创建 二 维 码 时 的 二 维 码 scene id 


Ticket 


二 维 码 的 ticket， 可 用 来 换取 二 维 码 图 片 


isScanEvent 用 于 判断 消息 类 型 是 否 为 已 关注 用 户 扫描 二 维 码 事件 : 









































const EVENT TYPE SCAN='SCAN ' ， 
/** 和 和 

大 
判断 是 否 为 已 关注 用 户 扫 描 二 维 码 事件 





























* Q@return boolean 


2 





public function isScanEvent () 


{ 














return $this-> postData->Event == self::EVENT TYPE SCAN; 

















—>text ( 
已 订 阅 用 户 汪 二 维 码 事件 ， 
是 :".S$Sdata->EventKey.'" a cket 












































让 
是 :".S$Sdata->Ticket."\nCreateTime 
是 :".S$Sdata->CreateTime)} 








“已 订阅 用 户 扫描 二 维 码 事件 ， Key 值 
是 :2014 
Ticket 值 

是 :gQE28DoAy SxodHRw 
| 0i8vd2VpeGluLnFxLmNvbSgxLzcw 
enlGSW5sRUdCcFVMNnhoMkpIAAI 
Eum18SUwMECACAAA== 
CreateTime 是 :1397911593 

















4.4.3 ”上 报 地 理 位 置 事件 
公众 号 可 以 在 公共 平台 网 站 上 修改 以 上 设置 。 上 报 地 理 位 置 时 ， 微 信 将 上 


人 从 与 


用 户 同意 上 报 地 理 位 置 后 ， 每 次 进入 公众 号 会 话 时 ， 都 会 在 进入 时 上 报 地 理 位 置 ， 或 者 在 进入 会 话 后 每 5 秒 上 报 一 次 地 理 位 置 ， 
报 地 理 位 置 事件 推送 到 开发 者 填写 的 URL。 


14:14 全 | 50 


出 门 问 问 要 求 使 用 你 的 地 理 位 置 ， 
否 允 许 ? 








消息 格式 如 下 : 


xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></FromUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><! [CDATA [event] ] ></MsgType> 

<Event><! [CDATA [LOCATION] ] ></Event> 
<Latitude>23.137466</Latitude> 
<Longitude>113.352425</Longitugde> 
<Precision>119.385040</Precision> 
</xml> 
































参数 说 明 见 下 表 : 
Event 
Latitude 


Longltude 


Preclslon 


isLocation 用 于 判断 消息 类 型 是 否 为 上 传 地 理 位 置 事件 : 


























const EVENT TYPE LOCATION="'LOCATION'; 


/** 
大 


判断 是 否 为 上 传 地 理 位 置 事件 
* Q@return boolean 
wy 
public function isLocaitonEvent () 


{ 

















return $this-> postData->Event == self::EV 














} 
sthis->text (" 
上 传 地 理 位 置 事件 ， 纬 度 是 :". $data->Latitude."\n 
经 度 是 :" .$data->Longitude."\n 
精度 是 :" .$data->Precision)} 











事件 类 型 ，LOCATION 
地 理 位 置 纬度 
地 理 位 置 经 度 
地 理 位 置 精度 


ON; 





EB LOCATI 














=== = 一 = 





时 ”上传 地 理 位 置 事件 ， 续 度 
是 :31.250036 
经 度 是 :120.721161 
精度 是 :68.000000 







































































4.3.4 自 定义 荣 单 事件 


用 户 点 击 自 定义 菜单 后 ， 如 果菜 单 按钮 是 Click 类 型 ， 微 信 会 把 点 击 事件 推送 给 开发 者 ; 如 果菜 单 按钮 是 View 类 型 ( 跳 转 到 URL) 或 者 点 击 菜单 弹出 子 菜单 ， 则 不 会 产生 上 报 。 
消息 格式 如 下 : 


<xml> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [FromUser] 1></FromUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><! [CDATA [event] ]></MsgType> 

<Event><! [CDATA[CLICK] ] ></Event> 
<EventKey><! [CDATA [EVENTKEY] ] ></EventKey> 
</xml> 



































参数 说 明 见 下 表 : 
参 数 摘 术 
Event 事件 类 型 ，CLICK 


EventKey 事件 KEY 人 但 ， 与 日 定义 亲 单 接口 中 KEY 值 对 应 


isClickEvent 用 于 判断 消息 类 型 是 否 为 点 击 菜单 拉 取 消息 事件 : 














Const EVENT TYPE CLICK="'CLICK'; 


/** 
壳 


判断 是 否 为 点 击 菜单 拉 取 消息 事件 
* Qreturn boolean 

*/ 

public function isClickEvent () 


{ 


} 

sthis->text (" 
点 击 菜单 拉 取 消息 事件 , Key 
值 是 :". $data->EventKey); 

































































return $this-> postData->Event == self::EVENT TYPE CLICK; 




















是 :V1001_TODAY_SINGER 








4.5 ”回复 消息 


对 于 每 一 个 POST 请 求 ， 开 发 者 需要 在 响应 包 中 返回 特定 XML 结构 的 响应 报 文 ， 现 在 支持 回复 文本 、 图 片 、 图 文 、 语 音 、 视 频 、 音 乐 。 


件 到 微 信 服务 器 。 


需要 注意 的 是 ， 回 复 图 片 等 多 媒体 消息 时 需要 预先 上 传 多 媒体 文 


微 信 服务 器 在 5 秒 内 收 不 到 响应 会 断 掉 链 接 ， 并 且 重 新 发 起 请 求 ， 最 多 重 试 三 次 。 所 以 我 们 需要 有 消息 的 排 重 机 制 ， 防 止 对 同一 消息 或 者 事件 回复 多 条 响应 消息 。 对 于 有 msgid 的 消息 可 以 使 用 msgid 排 


重 。 事 件 类 型 消息 则 可 以 使 用 FromUserName+ CreateTime 排 重 。 


对 于 某 些 耗 时 较 多 ， 无 法 保证 在 ? 秒 内 应 答 的 请 求 ， 可 以 直接 回复 空 串 ， 微 信服 务 器 不 会 对 此 做 任何 处 理 ， 并 且 不 会 发 起 重 试 。 在 这 种 情况 下 ， 可 以 使 用 客服 消息 接口 进行 异步 回复 ， 这 个 将 在 后 面 介 


7 
绍 。 


4.5.1 回复 文本 消息 


回复 文本 消息 格式 如 下 : 


<xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] 1></FromUserName> 
<CreateTime>12345678</CreateTime> 
<MsgType><! [CDATA [text] ] ></MsgType> 

<Content><! [CDATA [ 

你 好 ] ] ></Content> 








</xml> 

参数 说 明 见 下 表 : 
参 数 是 否 必 人 须 
MsgType 尽 text 
Content E 

具体 代码 如 下 : 





const REPLY TYPE TEXT = 'text';} 
/** Ez 


生成 向 用 户 发 送 的 文字 信息 























摘 述 


回复 的 消息 内 容 (换行 : 在 content 中 能 够 换行 ， 微 信 客 户 疹 就 
文 持 换行 显示 ) 


* Qparam string $content 
* Q@return string Xml 
字符 串 
Wh 
public function outputText ($content) 


{ 











$textTpl = '<xml> 
<ToUserName><! [CDATA[%$s]1></ToUserName> 
<FromUserName><! [CDATA[%s]1></FromUserName> 
<CreateTime>%$s</CreateTime> 
<MsgType><! [CDATA [SSs] ] ></MsdgType> 
<Content><! [CDATA [SSs] ] ></Content> 
</xml>'; 
$text=sprintf ($textTpl, Sthis-> postData->FromUserName, S$this-> 
postData->ToUserName, time(), self::REPLY TYPE TEXT, $content); 加 
heaqer ('Content-Type: application/xml'); 
echo stext; 
} 












































header 函 数 向 客户 端 发 送 原始 的 HTTP 报 头 ， 因 为 我 们 要 发 送 XML 格式 的 内 容 ， 定 义 Content-Type 为 application/xml。 


4.5.2 ”回复 图 片 消息 


回复 图 片 消息 格式 如 下 : 





<xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></FromUserName> 
<CreateTime>12345678</CreateTime> 

<MsgType><! [CDATA[image] ] ></MsgType> 

<lmage> 

<Mediald><! [CDATA[media id]]></MediaId> 
</Image> 

</xml> 




















参数 说 明 见 下 表 : 


说 有 明 





MsgType 扩 limage 
Mediald 尽 通过 上 传 多 媒体 文件 得 到 


具体 代码 如 下 : 








const REPLY TYPE IMAGE="'image'; 
/** 


大 
生成 向 用 户 发 送 的 图 片 信息 
* QQparam string $media id 
* Q@return string xml 
字符 串 
*/ 
public function outputImage ($media id) 


{ 

















i 

















$textTpl = '<xml> 
<ToUserName><! [CDATA[%$s]]1></ToUserName> 
<FromUserName><! [CDATA[%s]1></FromUserName> 
<CreateTime>%$s</CreateTime> 
<MsgType><! [CDATA[%$s] ] ></MsgType> 














<lImage> 
<MediaId><! [CDATA[%s]]></MediaId> 
</Image> 
</xml>'; 








$text=sprintf ($textTpl, Sthis-> postData->FromUserName, S$this-> 
postData->ToUserName, time(), self::REPLY TYPE IMAGE, $media id); 
header ('Content-Type: application/xml'); 


echo S$text; 



































注意 这 里 的 medialD 是 我 上 传 获取 的 ， 而 且 微 信服 务 器 对 多 媒体 只 保存 三 天 ， 所 以 读者 在 实验 这 段 代 码 时 请 自行 上 传 多 媒体 文件 获取 medialD。 随 后 我 们 将 介绍 上 传 下 载 多 媒体 的 接口 。 


站 i : —— i 
县 时 二 可 ms 扩 
al 


(人 约 微 信 公众 平台 测试 号 








4.5. 3 回复 语音 消息 心 \ 


复 语音 消息 格式 如 下 : 


<xml> 

<ToUserName><! [CDATA [toUser] 1></ToUserName> 
<FromUserName><! [CDATA [fromUser] ]></FromUserName> 
<CreateTime>12345678</CreateTime> 
<MsgType><! [CDATA [voice] ]></MsgType> 
































<Voice> 
<MedialId><! [CDATA[media id]]></MediaId> 
</Voice> 
</xml> 
参数 说 明 见 下 表 : 
参 数 说 明 
MsgType 是 语音 ，voice 
wm Yh ». ; » i = Zw 4 
Mediald 后 通过 上 传 多 媒体 文件 得 到 的 ID 
具体 代码 如 下 : 
Const REPLY TYPE VOICE = 'voice'; 
/** 
生成 向 用 户 发 送 的 语音 信息 





* Qparam string $content 
* Q@return string xml 
字符 串 
*/ 
public function outputVoice ($media id) 


{ 








$textTpl = '<xml> 
<ToUserName><! [CDATA[%$s]1></ToUserName> 
<FromUserName><! [CDATA[%s]]></FromUserName> 
<CreateTime>%$s</CreateTime> 
<MsgType><! [CDATA[%$s] ] ></MsgType> 








<Voice> 
<MediaId><! [CDATA[%s]]></MedialId> 
</Voice> 
</xml>'; 











$text=sprintf ($textTpl, Sthis-> postData->FromUserName, 
SEE > ToUserName, time(), self::REPLY TYPE VOICE, $media id); 



































header ('Content-Type: application/xml'); 
echo stext; 











“二 5” 性 





4.5.4 ”回复 视频 消息 


回复 视频 消息 格式 如 下 : 


<Xm]> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></EFromUserName> 
<CreateTime>12345678</CreateTime> 

<MsgType><! [CDATA[video] ]></MsgType> 

<Video> 

<MediaId><! [CDATA[media id]l]></MedialId> 

<Title><! [CDATA[title] ]></Title> 

<Description><! [CDATA[description]]></Description> 






































参数 说 明 见 下 表 : 
参 数 说 明 
MsgType 后 Video 
Mediald 中 通过 上 传 多 媒体 文件 得 到 的 ID 
Title 合 视频 消 且 的 标题 
Description 个 视频 消息 的 描述 
具体 代码 如 下 : 
UY REPLY TYPE VIDEO = 'Vvideo'; 


友 
生成 向 用 户 发 送 的 视频 信息 
* Qparam string $content 
* Q@return string xml 


个 











public function outputVideo ($videopost) 


$textTpl = '<xml> 


<ToUserName><! [CDATA[SS] ] ></ToUserName> 

<FromUserName><! [CDATA[%s]]1></FromUserName> 

<CreateTime>%$s</CreateTime> 

<MsgType><! [CDATA [SSs] ] ></MsgType> 

<Video> 
<MediaId><! [CDATA[%s]]></MedialId> 
<Title><! [CDATA[%s]]></Title> 
<Description><! [CDATA[%$s] ]></Description> 

</Video> 

</xml>'; 
$text=sprintf ($textTpl, $Sthis-> postData->FromUserName, 






























































$this-> postData ->ToUserName, time(), self::REPLY TYPE V DEO, $videopost['media id'], 
$videopost['title'], S$videopost['description']); 

header ('Content-Type: application/xml'); 

echo stext; 





} 


private function testVideo() 


{ 














$video = array( 
'media id' => 'Dx09rTLDC3nZKTSmfWMHXKxNxb01oTbgqn3yHtLPgTUMDJXSSamGW/uqNGRZp3of 


'title’' => ' 











独 墅 湖 '， 


生活 在 独 墅 湖 ' 
); 
$this->outputVideo ($video); 


'description' => ' 























视频 








回复 音乐 消息 格式 如 下 : 


<xml> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ]></FromUserName> 





<CreateTime>12345678</CreateTime> 
<MsgType><! [CDATA [music]]></MsgType> 
<Music> 
<Title><! [CDATA[TITLE] ]></Title> 

<Description><! [CDATA[DESCRIPTION] ] ></Description> 
<MusicUrl><! [CDATA [MUSIC Ur1]]></MusicUr1l> 
<HOMuUsicUrl><! [CDATA[HO MUSIC Url]]></HOMusicUr1> 
<ThumbMediaId><! [CDATA [media idq] ]></ThumbMediaId> 
</Music> 加 

</xml> 








l= 



































参数 说 明 见 下 表 : 


说 有明 





Msglype 自 music 
HQMusicUn 高 质量 音乐 链接 ，WiFi 环 境 优先 使 用 该 链接 播放 音乐 
AE 


ThumbMediald 缩 略 图 的 媒体 ID， 通 过 上 传 多 媒体 文件 得 到 的 ID 


具体 代码 如 下 : 














const REPLY TYPE MUSIC="'music'; 
/** 


克 
生成 向 用 户 发 送 的 音乐 信息 

* Qparam type $musicpost 

* Qreturn type 

* Qthrows Exception 

大 

/ 
public function outputMusic ($musicpost)t 
$textTpl = '<xml> 

<ToUserName><! [CDATA[%s]]></ToUserName> 
<FromUserName><! [CDATA[%s]1></FromUserName> 
<CreateTime>%$s</CreateTime> 
<MsgType><! [CDATA[%Ss]]1></MsgType> 











<Music>%s</Music> 
</xml>'; 
smusicTpl = " 





<Title><! [CDATA[%s]]></Title> 
<Description><! [CDATA[%Ss]]></Description> 
<MusicUrl><! [CDATA[%s]]1></MusicUr1> 
<HOMuUusicUrl><! [CDATA[%s]]></HQOMusicUr1> 

1 。 




















smusic = 77 
if (is array (smusicpost)){ 
smusic .= sprintf ($musicTpl, $musicpost['title'], $musicpost ['description'], 
smusicpost['musicurl'], $musicpost['hdmusicurl']); 
}elself 
throw new Exception('S$posts 


数据 结构 错误 ') ; 
} 


$text = sprintf ($textTpl, S$this-> postData->FromUserName, Sthis-> 
postData->ToUserName, time(), self::REPLY TYPE MUSIC, $music); 
header ('Content-Type: application/xml'); 


echo S$text; 























} 
private function testMusic () 


{ 

















Smusic = array( 





'title' => "' 
在 春天 里 " r 

"aqescription' => ' 
在 春天 里 - 
汪峰 '， 





'musicurl' => 'http://rubyeye-rubyeye.stor.sinaapp.com/inspring.wma', 
'hgmusicurl' => 'http://rubyeye-rubyeye.stor.sinaapp.com/inspring .mp3" 


Sthis->outputMusic ($music); 





众 平台 测试 号 

















4.2.6 回复 图 文 消息 


回复 图 文 消息 格式 如 下 : 





<xml> 

<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></EFromUserName> 
<CreateTime>12345678</CreateTime> 
<MsgType><! [CDATA [news] ] ></MsgType> 
<ArticleCount>2</ArticleCount> 

<Articles> 
<item> 
<Title><! [CDATA[titlell]></Title> 

<Description><! [CDATA[description1l]]></Description> 
<PicUrl><! [CDATA[picurl]]></PicUr1l> 
<Url><! [CDATA [ur1] 1></Ur1> 

</item> 

<item> 

<Title><! [CDATA[title] 1></Title> 
<Description><! [CDATA[description]]></Description> 
<PicUrl><! [CDATA[picurl]]></PicUr1l> 
<Url><! [CDATA [ur1] 1></Ur1> 
























































</item> 
</Articles> 
</xml> 
参数 说 明 见 下 表 : 
参 类 说 明 
ArticleCount 是 图 文 消息 个 数 ， 限 制 为 10 条 以 内 
( 绥 ) 
参 类 说 明 
上 多 条 图 文 消 息 信 息 ， 默 认 第 一 个 item 为 大 图 ,注意 ， 如 果 图 文 数 
Articles 在 No pp 
超过 10， 并 无 啊 应 
Title 合 图 文 消 县 标题 
Description 和 图 文 消息 搞 述 
图 片 链接 ， 文 持 JPG、PNG 格 式 ， 较 好 的 效果 为 大 图 360 x 200 
PicUrl 合 ca 的 
像素 ， 小 图 200 x 200 像 素 
Url 点 击 图 文 消息 跳 转 链接 
具体 代码 如 下 : 
const REPLY TYPE NEWS = 'News'} 
/** 
生成 向 用 户 发 送 的 图 文 信息 


* Qparam arrry S$posts 
文章 数组 ， 每 一 个 元 素 是 一 个 文章 数组 ， 索 引 跟 微 信 官方 接口 说 明 一 臻 
* Q@return string xml 
符 串 
public function outputNews ($posts = array ()) 
{ 








忆 





$textTpl = '<xml> 
<ToUserName><! [CDATA[%$s]1></ToUserName> 
<FromUserName><! [CDATA[%$s] 1></FromUserName> 
<CreateTime>%s</CreateTime> 
<MsgType><! [CDATA[%Ss]]></MsgType> 
<ArticleCount>%d</ArticleCount> 
<Articles>%s</Articles> 
</xml>'} 
$itemTpl = '<item> 
<Title><! [CDATA[%s]]></Title> 
<Discription><! [CDATA[%$s] ]></Discription> 
<PicUrl><! [CDATA[%$s]]1></PicUr1l> 
<Url><! [CDATA[%s]]></Ur1> 
</item>'; 
$items = "''} 
foreach ((array) S$posts as SP) { 
if (is array($p)) 
$items .= sprintf ($itemTpl, S$pl'title'], $pl'discription'], $pl['picurl'], $p['url']); 
else 


数据 结构 错误 ') 
} 
$text=sprintf ($textTpl, Sthis-> postData->FromUserName, S$this-> 
PostData-> ToUserName, time(), self::REPLY TYPE NEWS, count($posts), $items); 
header ('Content-Type: application/xml'); 
echo stext; 


























throw new Exception('S$posts 












































} 


private function testNews () 


{ 

















$posts = array( 
array( 


'title' => ' 
世界 因 你 而 不 同 '， 
'discription' => " 


最 大 化 你 的 影响 力 ， 这 就 是 你 一 生 的 意义 。'， 
‘picurl' => 'http://www.hers.cn/uploadfile/2011/1006/2011- 
1006022157183.jpg"', 

'url' => 'http://mp.weixin.gqgq.com/mp/appmsg/show? biz=MjMS5MDE 
4Njg2MO==&appmsgid=10000072g&itemidx=1l&sign=bea6deb75836dbel1249dcf394e8f3c21#wec 
hat redirect"', 

), 
array( 
'title' => ) 





























_ "discription' => " 
心 要 多 静 才 能 保持 如 此 的 平衡 '， 
'picurl' => 'http://news.shangdu.com/304/2009/08/20/images/ 

















501 20090820 911.jpg', 
'url' => 'ht 


EAN 





tp://mp.weixin.gq.com/mp/appmsg/show? biz=MjM5MDI 





jg92MO==&appmsgid=10000066&i 
) 


); 
// outputNews 
来 返回 图 文 信息 

















ee 





temidx=1l#wechat redirect"', 


$xml = Sthis->outputNews ($posts); 





到 上 ij 下 hn i 
i 微 信和 公众 
( 入 微 信 





4.6 生成 市 参数 的 二 维 码 


为 了 满足 用 户 渠道 推广 分 析 的 需要 ， 公 众 平 台 提 供 了 生成 二 维 码 的 接口 。 使 用 该 接口 可 以 获得 多 个 带 不 同 场景 值 的 二 维 码 ， 用 户 扫描 后 ， 公 众 号 可 以 接收 到 事件 推送 。 


微 信 支持 两 种 类 型 的 二 维 码 : 临时 二 维 码 和 永久 二 维 码 。 前 者 有 过 期 时 间 ， 最 大 为 1800 秒 ， 但 能 够 生成 数量 较 多 ， 后 者 无 过 期 时 间 ， 数 量 较 少 (目前 参数 只 支持 1~10000) 。 两 种 二 维 码 分 别 适用 于 账 
号 绑 定 、 用 户 来 源 统 计 等 场景 。 


前 面 已 经 介绍 过 对 推送 二 维 码 事件 的 处 理 ， 这 节 我 们 将 介绍 如 何 生 成 二 维 码 。 获 取 带 参数 的 二 维 码 的 过 程 包 括 两 步 ， 首 先 创建 二 维 码 ticket， 然 后 凭借 ticket 到 指定 URL 换 取 二 维 码 。 


4.6.1 创建 二 维 码 ticket 


请 求 地址 : 
https://api.weixin.qq.com/cgi-bin/qrcode/create?access token=TOKEN 


POST 数 据 格式 是 json， 临 时 二 维 码 的 格式 如 下 : 




















{"expire seconds": 1800, "action name": "QR SCENE", "action info": {"scene": {"scene id": 123}}} 





永久 二 维 码 的 格式 : 
































{"action name": "QR LIMIT SCENE", "action info": {"scene": {"scene idq": 123}}} 








参数 说 明 见 下 表 : 


参数 说 明 


exXplIe Seconds 沪 二 维 抬 有效 时 间 ， 以 秒 为 单位 ， 最 大 不 超过 1800 
actlon_ name 二 维 码 类 型 ，QR SCENE 为 临时 ,QR LIMIT SCENE 为 永久 
action info 二 维 码 详细 信息 


场景 值 ID ， 临 时 二 维 码 时 为 32 位 非 0 整 型 ， 永 久 二 维 码 时 最 大 值 为 100000 ( 目前 参数 只 文 


scene 1d es 
持 1 ~ 100000 ) 
正确 的 json 返 回 结果 : 


























{"ticket":"gQG28DoAAAAAAAAAASxodHRwOi8vd2VpeGluLNFxLMNVvbS9xLOFUWC1 DNMmZUVENvMVPANDNMRNNRAATEeSLVUOMECACAAA==", "expire seconds":1800} 





























参数 说 明 见 下 表 : 
参 数 说 上 明 
ticket 获取 的 二 维 码 ticket， 凭 信 此 ticket 可 以 在 有 效 时 间 内 换取 二 维 码 
expire_seconds 二 维 码 的 有 效 时 间 ， 以 秒 为 单位 ， 最 大 不 超过 1800 


错误 的 json 返 回 示例 : 





{"errcode":40013,"errmsg":"invalid appid"} 
/** 
大 
获取 ticket 
* @param {int} $scene id 
* Qparam {int} S$expire 
* Qreturn {string} ticket 
证 4 
public static function getQrcodeTicket ( $scene id = 0, $expire = 0 ){ 
$access token = self::getToken(); 
$scene id = intval($scene iqd); 
Sexpire intval ($expire); 


if( $expire | 94 
临时 二 维 码 





























$data = array( 
'action name' => 'QR SCENE ' ， 
'action info' => array( 
'scene' => arrayl( 
'scene id' => $scene id 




















) 
), 
'expire seconds' => $expire, 
); 
}Jelse{ // 
永久 二 维 码 


永久 二 维 码 的 scene id 
只 文 持 1 


“i100000 








if( $scene id <1 | 
$scene id = 1; 


$scene id > 100000 ){// 





} 
$data = array( 
"action name' => 'QR LIMIT SCENE '， 























"action info' => array ( 
'scene' => artray( 
'scene id' => $scene id 





) 


); 
} 



































$url = self::API URL."/cgi-bin/grcode/create?access token=$access token"; 
$content = curl post( $url, json encode( $data ) ); 
$ret = self::getResult (json decode( $content, true )); 
return isset(S$ret['ticket'])?$ret['ticket']:false; 
} 
public static function getResult ($ret) { 














if(!is array ($ret) || !array key exists('errcode',sret))t 
return $ret; 











} 

Serrcode = intval ($ret['errcode']); 

if (in array ($errcode, self::S$ERRCODE MAP) ) { 

f(Serrcode == 0){ 加 
return true; 





























PF- 


} 


return array('errcode' => $errcode, ‘'errinfo' => self::$ERRCODE MAP[$errcodel]); 





























} 


return array('errcode'=>'-2','errinfo'=>" 


未 知 错误 ')， 
} 








getResult 函 数 对 返回 结果 进行 处 理 。 


4.6.2 ”通过 ticket 换 取 二 维 码 


获取 二 维 码 ticket 后 ， 开 发 者 可 用 ticket 换 取 二 维 码 图 片 。 这 个 接口 使 用 GET 请 求 方 式 ， 且 无 须 登录 态 即 可 调用 ( 即 无 需 身份 验证 ， 任 何人 都 可 以 调用 ) 。 
HTTP 请 求 地 址 : 

https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET 

注意 由 于 ticket 中 可 能 存在 +， 而 + 在 URL 中 代表 空格 ， 所 以 需要 进行 URL 编 码 。 


ticket 正 确 情况 下 ，http 返 回 码 是 200， 是 一 张 图 片 ， 可 以 直接 展示 或 者 下 载 。 错 误 情 况 下 ， 返 回 HTTP 错 误 码 404。 


/** 
* 

获取 二 维 码 图 片 url 
* Qparam {string} Sticket 
* Qreturn {string} 


























图 片 url 
*/ 
public static function getQrcodeImgUrlByTicket( Sticket ) { 
Sticket = urlencode( Sticket ); 
return "https://mp.weixin.gqq.com/cgi-bin/showqrcode?ticket=$ticket"; 








showqrcode (430xd430) 其 

















4.7 ”客服 接口 


当 用 户主 动 发 消息 给 公众 号 时 (包括 发 送信 息 、 点 击 自 定义 菜单 、 订 阅 事 件 、 扫 描 二 维 码 事件 、 支 付 成 功 事件 、 用 户 维权 ) ， 微 信 会 把 消息 数据 推送 给 开发 者 ， 开 发 者 在 一 段 时 间 内 (现在 是 48 小 时 ) 
可 以 调用 客服 消息 接口 ， 通 过 POST 一 个 JSJON 数 据 包 来 发 送 消息 给 用 户 ， 在 48 小 时 内 不 限制 发送 次 数 。 次 接口 主要 用 于 客服 等 有 人 工 消 息 处 理 的 环节 ， 方 便 开发 者 为 用 户 提供 更 加 优质 的 服务 。 


接口 地 址 是 : https://api.weixin.qq.com/cgi-bin/message/custom/send?access token=ACCESS TOKEN 
发 送 的 消息 类 型 与 被 动 响应 消息 类 型 一 致 ， 也 有 六 种 ， 而 且 格 式 也 比较 类 似 ， 下 面 给 出 每 个 消息 的 格式 。 


文本 消息 : 





"touser": "OPENID™, 
"msgtype":"text", 
1 tex 巧 于 




















"content":"Hello World" 


图 片 消息 : 


{ 





"touser": "OPENID™, 
"msgtype":"image", 
"image": 














"media id":"MEDIA ID" 

















be he EA 入 
语音 消息 。 





"touser":"OPENID™, 
"msgtype":"voice", 
"voice": 





























"media id":"MEDIA ID" 
} 


视频 消息 : 





"touser": "OPENID™, 
"msgtype":"video", 
"video": 
{ 
"media id"™":"MEDIA ID", 
"EE 
"description":"DESCRIPTION" 
} 





















































音 8 < 消 息 











"touser": "OPENID™, 
"msgtype":"music", 
"music": 


{ 








"title":"MUSIC TITLE", 
"description":"MUSIC DESCRIPTION", 
"musicurl":"MUSIC URL", 
"hqmusicurl": "HO MUSIC URL", 

"thumb media id":"THUMB MEDIA ID" 
























































图 文 消息 : 














"touser": "OPENID™, 

"msgtype": "news", 

"news":{ 

"articles": [ 
{ 

"title":"Happy Day", 
"description":"Is Really A Happy Day", 
Da . J 
"pi Curl 1 : "PIC URL" 

















"title":"Happy Day", 

"description":"Is Really A Happy Day", 
yurEL™ : TR 
"pi Curl TY : "PIC URL" 




















具体 代码 如 下 : 








private static function send( StoUser，SmsgType，S$qata ) { 
$access token = Self::getToken (); 























$url = self::API URL . "/cgi-bin/message/custom/send?access token=$access token"; 
$json = json encode( 
array ( 
'touser' => S$toUser, 
'msgtype' => $msgType, 
$msgType => $data 


) 
); 
$ret = curl post ($url, $json); 


return self::getResult( $ret ) ， 














} 
/** 
大 
发 送 文 本 消息 
* Qparam {string} S$toUser 
* Qparam {string} S$content 














* Qreturn type 
public static function senqText (StoUser，Scontent) { 
return self:: send( StoUser，'text'，， array( 'content' => $content ) ); 
} 
/** 
大 
发 送 图 片 消息 











* Qparam {string} S$toUser 
* Qparam {string} $media id 














* Qreturn type 
wy 
public static function sendImage( S$toUser, $media idq ) { 
return self:: send( $toUser, 'image', array( 'media id' => $media idq )); 
} 
/** 
大 
发 送 语音 消息 


* Qparam {string} S$toUser 
* Qparam {string} $media id 











* Qreturn type 
public static function sendVoice( $toUser, $media id ) { 
return self:: send( $toUser, 'voice', array( 'media id' => $media idq ) ); 
} 
/** 
大 
发 送 视 频 消 息 


* Qparam {string} S$toUser 
* Qparam {string} $media id 
* Qparam {string} $title 
大 
大 








@Qparam {string} S$desc 








Greturn type 
0 
public static function sendVideo( $toUser, $media id, $title, $desc ){ 
return self:: send( $toUser, 'video', arrayl( 
'media id' => $media id 
“ 巧 业 Eee => $title, 
'description' => S$desc 
) ); 
} 
/** 
* 
发 送 音乐 消息 





* Qparam {string} S$toUser 
* Qparam {string} $media id 




















* Qreturn type 
*/ 
public static function sendMusic( $toUser, $url, $thumb mid, $title, $desc = '', Sha url = "'" ){ 
return self:: send( $toUser, 'music', arrayl( 
'title'" => $title, 
'description' => Sdesc || $title, 
'musicurl' => $url, 
‘thumb media id' => $thumb midg, 
'haqmusicurl' => Shaq_ url || $url 
) ); 
} 
/** 
* 
发 送 图 文 消息 
* Sarticles = array( 
* array( 
交 "title"=>"Happy Day", 





"description"=>"Is Really A Happy Day", 
wirlL"=>"URL" 
Won Curl mm 一 > PIC URL" 








), 

* ); 

* Qparam {string} S$toUser 

* Qparam {string} Sarticles 
* Q@return type 








*) 
public static function sendNews ($toUser, Sarticles) { 
return self:: send( $toUser, 'news', array( 
'articles' => S$articles, 





) ); 


4.8 语音 识别 | 


4.8.1 ”让 微 信 听 习 你 的 话 


微 信 识 别 功 能 默认 是 关闭 的 ， 需 要 开通 ， 开 通 语 音 识 别 功 能 后 ， 用 户 每 次 发 送 语音 消息 给 公众 号 时 ， 微 信 会 在 推送 的 语音 消息 XML 数 据 包 中 ， 增 加 一 个 Recongnition 字 段 。 需 要 注意 的 是 ， 由 于 客户 端 
缓存 ， 开 发 者 开启 或 者 关闭 语音 识别 功能 ， 对 新 关注 者 立即 生效 ， 对 已 关注 用 户 需 要 24 小 时 生效 。 开 发 者 可 以 重新 关注 此 账号 进行 测试 。 


开局 语音 识别 后 的 语音 XML 数据 包 格 式 如 下 : 


<xml> 
<ToUserName><! [CDATA [toUser] 1></ToUserName> 
<FromUserName><! [CDATA [fromUser] ] ></EFromUserName> 
<CreateTime>1357290913</CreateTime> 
<MsgType><! [CDATA [voice] ]></MsgType> 
<MedialId><! [CDATA[media id]]></MediaId> 
<Format><! [CDATA [Format]1></Format> 
<Recognition><! [CDATA[ 

腾讯 微 信 团队 ] ] ></Recognition> 
<MsgId>1234567890123456</MsgIgd> 

</xml> 


























参数 说 明 见 下 表 : 


Recognition 踢 首 诸 


4.8 语音 识别 | 


4.8.1 ”让 微 信 听 慌 你 的 话 


微 信 识 别 功 能 默认 是 关闭 的 ， 需 要 开通 ， 开 通 语 音 识别 功能 后 ， 用 户 每 次 发 送 语音 消息 给 公众 号 时 ， 微 信 会 在 推送 的 语音 消息 XM| 数 据 包 中 ， 增 加 一 个 Recongnition 字 段 。 需 要 注意 的 是 ， 由 于 客户 端 
缓存 ， 开 发 者 开启 或 者 关闭 语音 识别 功能 ， 对 新 关注 者 立即 生效 ， 对 已 关注 用 户 需 要 24 小 时 生效 。 开 发 者 可 以 重新 关注 此 账号 进行 测试 。 


开局 语音 识别 后 的 语音 XML 数据 包 格 式 如 下 : 


<xml> 
<ToUserName><! [CDATA [toUser] ] ></ToUserName> 
<FromUserName><! [CDATA [fromUser] 1></FromUserName> 
<CreateTime>1357290913</CreateTime> 
<MsgType><! [CDATA [voice] ]></MsgType> 
<MedialId><! [CDATA[media id]]></MediaId> 
<Format><! [CDATA [Format]]1></Format> 
<Recognition><! [CDATA[ 

腾讯 微 信 团队 ] ] ></Recognition> 
<MsgId>1234567890123456</MsgIgd> 

</xml> 




















参数 说 明 见 下 表 : 


Recognition 踢 首 计 


4.8.2 ”翻译 助手 


这 一 节 我 们 实现 一 个 很 实用 的 功能 : 翻译 助手 。 帮 助 我 们 翻译 输入 的 文本 和 语音 消息 ， 支 持 多 种 语音 的 互 译 。 规 则 是 ， 消 息 的 头 两 个 字 是 翻译 ， 我 们 就 会 翻译 后 面 的 文本 ， 如 果 是 中 文 ， 翻 译 成 英文， 
如 果 是 非 中 文 ， 翻 译 成 中 文 。 比 较 知名 的 翻译 API 包 括 : 


有 道 翻译 API: http://fanyi.youdao.com/openapi 
“ 百度 翻译 API: http://openapi.baidu.com/public/2.0/bmt/translate 
必 应 翻译 API: http://www.mictosoft.com/en-us/translator/developers.aspx 


这 里 我 们 采用 有 道 翻 译 API。 由 于 有 些 API 有 使 用 次 数 的 限制 ， 或 者 有 些 消息 不 能 翻译 ， 在 实际 产品 中 ， 可 以 采用 多 种 API 备 份 的 方式 ， 如 果 APl 使 用 次 数 达到 上 限 ， 或 者 消息 没有 结果 ， 切 换 其 他 API 再 
做 尝试 。 


1. 申 请 API 访 问 权限 及 接口 说 明 


到 http://fanyiyoudao.com/openap 选 择 调用 数据 接口 ， 按 照 提示 填写 信息 ， 点 击 申请 ， 就 会 在 按钮 下 方 显示 申请 成 功 的 提示 ， 并 给 出 AP| key 和 keyfrom， 如 下 图 所 示 : 
申请 key (在 使 用 有 道 则 笃 API 前 ;你 需要 寺 申 请 key》 


加 村: | maoyaaaot | 瑟 个 全 竺 ， 忆 拓 子 世 般 宁 县 于 付 ， 间 六 相 续 夺 必 油 是 子 峡 束 部 子 

















区 当地 址 :| nttp-WBJhuoyaxiaotu_sinaapp .conuapi php 下 此 请 号 应 月 所 在 网 站 或 应 月 的 支持 品 站 
网 站 说 昌 向 信和 公共 号 在 此 柱 进 疗 的 同 站 或 应 用 ， 干 超过 200 宁 
联系 方式 ;| zhoutao908Bgmailcom 电话 昌隆 外 可 

国 我 接 有 等 有 着 秋 译 AP 使 用 盾 喜 
有 道 翻译 API 申 请 成 功 


AP| key: 232203214 
Keyfrom: huoyaxiaotus 


电 | 建 时 间 : 201404-22 
装 站 息 秆 : huoraxiaohua 
时 焉 项 未 : http huoyvadactysinaapp.comapphp 


有 道 API 的 请 求 频率 限制 为 每 小 时 1000 次 ， 超 过 限制 会 被 封禁 。 开 发 者 可 以 采用 前 面 提 到 | 的 方法 ， 申 请 多 个 API 作 为 后 备 。 有 道 APl 也 提供 了 申请 放宽 限制 的 方法 ， 开 发 者 也 可 考虑 。 


有 道 API 的 接口 如 下 : 


























http://fanyi.youdao.com/openapi .do?keyfrom=KEYFROM&key=APIKEY&type=data&doctype=DOCTYPE&version=1 .1&q= 














要 翻译 的 文本 
参数 说 明 见 下 表 : 
KEYFROM 在 有 道 注册 的 网 站 名 称 
KEYAPI 有 过分 配 的 key 
DOCTYPE 返回 结果 的 数据 格式 ，xml、json 或 者 jsonp 
q 要 翻译 的 文本 ， 必 须 是 UTF-8 编 码 ， 字 人 符 长 度 不 超过 200 个 字符 ， 需 要 进行 urlencode 编 伍 


错误 码 见 下 表 : 


errorCode 摘 述 


一 个 json 数 据 格 式 的 例子 : 











http://fanyi.youdao.com/openapi .do?keyfrom=huoyaxiaotu8&key=232203214&type=data&doctype=json&version=1.1&gq=good 
{ 





"errorCode":0 
"query™" “ "good" 六 
"translation™":[" 
好 "]，// 
道 翻译 
sasieu st // 
道 词典 - 
基本 词典 
"phonetic":"g d" 
"uk-phonetic":"g d" // 



































英 式 发 音 
"us-phonetic™":" 
g d" // 
美式 发 音 
"explains":1| 
好 处 "， 
好 的 " 
女 TY 
| 
}， 
"web"™: [ 27 
了 道 词典 - 
网 络 释义 
{ 
"key" “ "good", 
"value":[" 
良好 LL 
善 "， TY 
美好 "] 


}, 


{http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/...} 

















2. 程 序 实现 


本 书 采 用 son 的 数据 格式 ， 判 断 所 接收 消息 的 类 型 ， 如 果 是 文本 消息 ， 处 理 文本 正文 ; 如果 是 语音 消息 ， 处 理 语音 识别 后 的 文本 。 








public function processRequest ($data) { 
sae log(var export ($data, TRUE)); 
$sthis->sendmsg = new SendMsgDB (); 
if (S$this->isTextMsg()) 1 
Sthis->processText ($data->Content); 























} 
elseif (Sthis->isVoiceMsg()) { 
Sthis->processText ($data->Recognition); 

















} 




















如 果 文 本 消息 前 两 个 字 是 翻译 ， 调 用 翻译 助手 翻译 ， 如 果 不 是 ， 直 接 返 回 文本 内 容 。 


mb _substr 和 mb_strlen 能 够 根据 编码 格式 进行 字符 处 理 ， 而 substr 类 的 函数 只 支持 单字 节 的 AsCll 编 码 ， 因 为 文本 中 含有 中 文 等 双 字 节 编码 ， 所 以 这 里 采用 mb_substr 函 数 。 











private function processText ($data) 


{ 








$firstTwoWord = mb substr ($data,0,2,"UTF-8"); 
$len = mb strlen ($data, 'UTF-8°"');} 
if ($firstTwoWord == " 
翻译 ' && S$Slen > 2) 
{ 














$result = translationHelper (mb substr ($data,2,$len, 'UTF-8"')); 
Sthis->outputText ($result); 








} 


else 


{ 

} 
} 
define ('KEYFROM', 'huoyaxiaotu8'); 


define ('APIKEY', '232203214"');} 
function translationHelper ($msg) 





Sthis->outputText ($data); 









































$youdaoUrl = 'http://fanyi.youdao.com/fanyiapi .do?keyfrom=" .KEYFROM.'&key=". 
APIKEY.'&type=data&doctype=json&version=1.1&q=" .$msg; 
$content=curl get ($youdaoUrl1); 
$ret=json decode ($content, true); 
$result = "' 
深呼吸 ， 再 试 一 次 '; 












































if(array key exists('errorCode', $ret)){ 
Switch ($ret['errorCode']) 
{ 
case 0: 
$result = $ret['translation']['0']; 
break; 
case 20: 
$result = " 
你 的 消息 太 长 了 哦 '; 
break; 
case 30: 
$result = "' 
翻译 助手 也 有 不 会 翻译 的 时 候 哦 '， 
break; 
case 40: 


$result = " 

















本 助手 是 有 原则 的 ， 


不 翻译 鸟 语 ， 
哼 '; 





break; 
case 50: 


$result = "' 
不 要 胡言 乱 语 ， 说 人 话 '; 
} 


break; 


return Sresult; 





分 别 用 语音 消息 和 文本 消息 输入 “翻译 今天 天 气 怎 么 样 ”的 效果 见 下 图 。 





yn ((e 








:ather like today 


= = === = = = < = 














翻译 今天 天 气 怎么 样 





人 的 


了 工 -Whatsthe weather like today 








第 5 草 ”高 级 接口 


微 信 推出 了 认证 服务 体系 ， 对 通过 认证 的 公众 号 提供 了 很 多 高 级 接口 ， 包 括 自 定 义 菜单 、 上 传 下 载 多 媒体 文件 、 用 户 管理 、 获 取 用 户 地 理 位 置 、OAuth2.0 网 页 授权 、 高 级 群发 接口 、 多 客服 功能 、 微 信 
小 店 等 接口 。 通 过 这 些 接口 公众 号 开发 者 能 够 为 用 户 提供 更 多 个 性 化 的 服务 ， 打 造 出 不 逊色 于 原生 应 用 的 轻 应 用 。 微 信 公 众 号 平台 还 处 在 高 速 发 展 的 过 程 中 ， 新 的 接口 不 断 被 提供 ， 老 接口 的 功能 也 可 能 被 
调整 ， 开 发 者 需要 关注 接口 的 变化 ， 充 分 利用 微 信 提 供 的 接口 开发 出 好 玩 易 用 的 功能 。 


5.1 和 目 定义 采 
服务 号 相对 订阅 号 最 大 的 一 个 好 处 就 是 自 定义 菜单 了 ， 自 定义 菜单 使 得 我 们 的 公众 号 更 像 一 个 应 用 ， 能 让 用 户 在 关注 公众 号 的 短 时 间 内 ， 简 单 明 晰 地 了 解 公 众 号 的 功能 ， 提 高 用 户 的 留存 率 。 相 对 输入 


文本 或 者 其 他 类 型 的 消息 ， 点 击 菜单 更 能 激发 用 户 的 互动 欲望 ， 是 更 加 直接 有 效 的 互动 模式 。 


自 定义 菜单 功能 开启 后 ， 界 面 如 下 图 所 示 : 


和 fey Wecash 


-= Wd 大 -= 
青春 " 购 "”， 享 生活 





守业 那 年 ， 你 的 第 一 笔 工 资 有 普 少 ? 





WecashI 银 CED 支 正春 参加 区 瑞峰 会 
演讲 PPT ( 地 图 , 慎 点 ) 


0 4000+ 月 薪 招 实习 


快 坏 1 | i 
i 三 组 沫 音 





是 现 


担 升 信用 多 上 度 





| ”授信 /提现 ， 





目前 自 定义 菜单 最 多 包括 3 个 一 级 菜单 ， 每 个 一 级 菜单 最 多 包括 5 个 二 级 菜单 。 一 级 菜单 最 多 显示 4 个 汉字 ， 二 级 菜单 最 多 显示 7 个 汉字 ， 多 出 来 的 部 分 将 会 以 “…” 代 蔡 。 
S 注意 创建 自 定 义 菜单 后 ， 由 于 微 信 客户 端的 缓存 ， 需 要 24 小 时 微 信 客户 端 才 会 展现 出 来 。 建 议 测 试 时 可 以 尝试 取消 关注 公共 账号 后 再 次 关注 ， 则 可 以 看 到 创建 后 的 效果 。 
1. 自 定义 菜单 类 型 
自 定义 菜单 的 每 一 项 可 以 视 之 为 一 个 按钮 ， 微 信 公 共 平 台 支 持 Click 和 View 两 种 类 型 的 按钮 。 
Click: 用 户 点 击 Click 类 型 按钮 后 ， 微 信服 务 器 会 通过 消息 接口 推送 事件 类 型 的 消息 给 开发 者 〈 见 第 4 章 ) ， 消 息 中 含有 按钮 中 开发 者 填写 的 key 值 ， 开 发 者 可 以 通过 自 定 义 的 key 值 与 用 户 进行 交互 。 


* View: 用 户 点 击 View 类 型 按钮 后 ， 微 信 内 置 浏览 器 将 会 打开 开发 者 在 按钮 中 填写 的 URL， 建 议 与 网 页 授权 获取 用 户 基本 信息 接口 〈《OAuth2.0 网 页 授权 ， 第 8 章 介绍 ) 结合 使 用 ， 获 得 用 户 的 登录 个 人 信 


息 。 
具体 属性 见 下 表 
按钮 类 型 属 性 属性 说 明 
按钮 类 型 ， 这 里 是 Click 
Name 菜单 标题 ， 不 超过 16 个 字 节 ， 最 多 显示 4 个 汉字 ， 子 菜单 不 超过 40 个 字 节 ， 最 
Click 多 显示 7 个 汉字 
Key 用 户 点 击 时 ， 微 信服 务 需 返回 的 但 ， 开 发 者 根据 这 个 值 来 判断 用 户 点 击 的 是 哪 
个 按钮 ， 不 超过 128 个 字 节 
按钮 类 型 ， 这 里 是 View 
View Name 菜单 标题 ， 不 超过 16 个 字 节 ， 最 多 显示 4 个 汉字 ， 子 菜单 不 超过 40 个 字 节 ， 最 
多 显示 7 个 汉字 
用 户 点 击 时 ， 跳 转 到 的 网 页 链接 ， 不 超过 256 个 字 节 
2. 接 口 说 明 


接口 URL 是 : https://api.weixin.qq.com/cgi-bin/menu/create?access token=ACCESS TOKEN ，access token (凭证 ) 的 申请 已 经 在 第 4 章 介绍 过 了 。 这 个 接口 使 用 POST 方式 提交 json 数 据 ， 数 据 
的 格式 如 下 : 
























































{ 
"buttorn :| 
Aane™ : 1 
授信 \ 
提现 "， 
"sub putton": [ 
{ 
"七 YPe 7” “ WT EW 5 
"name" “ 1 
闪电 授信 "， 
wurl™":"http://www.soso.com/" 
}, 
{ 
"type" “ "Viewn x 
"name" mw 
快速 提现 "， 
Ml htto://v. a con/™ 
}, 
{ 
tye volLek" 
nname"™ “ mw 
提升 信用 额度 "， 
"key":"V1001 CREDITLIMIT" 
}] 
}, 
| 
"type GTCKI7 
name Ww 
我 "， 
"key":"V1001 ME" 
}， 
{ 
"type":"click", 
和 name 必 玫 于 
更 多 服务 "， 
"Key":"V1001 MORESERVICES" 
}] 
} 
在 这 个 json 数 据 结 构 中 ， 有 三 个 一 级 菜单 : “授信 /提现 ”，“ 我 ”和 “更 多 服务 ”。 在 一 级 菜单 “授信 /提现 ”下 面 设置 了 “闪电 授信 ”、 “快速 提现 ”、 “提升 信用 额度 ”三 个 二 级 菜单 。 提 交 创 建 


自 定义 菜单 请 求 后 ， 如 果 正 确 ， 返 回 的 JSON 数 据 包 如 下 : 





{"errcode":0,"errmsg":"ok"} 





如 果 错 误 ， 返 回 的 JSON 数 据 包 则 类 似 这 样 (以 无 效 菜单 长 度 为 例 ) : 





{"errcode":40018, "errmsg":"invalid button name size"} 


3. 接 口 封装 











public static function createMenu (Smenu) { 
$url=self::API URL."/cgi-bin/menu/create?access token=" .self::getToken (); 
$content=curl post ($url, $menu); 














可 
WW 











$ret=json decode ($content,true); 
return wxcommon: :getResult ($ret); 


4. 测 试 案例 








private function testCreateMenu () 





{ 
Smenu = '{ button" :[ 
"name":" 
授信 \ 
提现 "， 
"sub putton": [ 
{ 
"type":"view", 
"name™":" 
闪电 授信 "， 
wurl":"http://www.soso.com/" 
}, 
{ 
"type":"view", 
"name™":" 
快速 提现 "， 
VirIV "htto/ /vacom/" 
}, 
{ 
type "oliek 
"name™":" 
提升 信用 额度 "， 








"key":"V1001_ CREDITLIMIT" 

















}] 


"七 YPe 7” “ "click", 
"name" el 





"Key":"V1001 ME 


type" "elLLiek", 
Tame . wr 




















‘key™": "V1001 MORESERVICES" 




















ret = self::createMenu ($menu); 
Sthis->outputText ($ret); 





最 终 效果 如 下 图 所 示 : 





闪电 授信 


快速 握 现 


提升 信用 额度 
































= = pe = = = 3 一 王 = 和- 和 3 于 下 全 全 下 下 全 全 下 下 下 二 下 和 二 二 -一 














5.1.2” 目 定义 菜单 的 查询 和 删除 


创建 自 定义 菜单 后 ， 开 发 者 还 可 以 使 用 接口 查询 和 删除 自 定义 菜单 的 结构 ， 这 两 个 接口 意义 不 大 。 


查询 接口 地 址 为 : https://api.weixin.qq.com/cgi-bin/menu/get?access token=ACCESS TOKEN。 删 除 接口 地 址 : https://api.weixin.qq.com/cgi-bin/menu/delete? 
access token=ACCESS TOKEN。 


使 用 HTTPS GET 方 式 提交 申请 ， 查 询 接口 返回 创建 菜单 的 JJON 结 构 数据 : 


{"menu": {"button": [{"name":" 
nA 


提现 ", "sub button":[{"type":"view", "name™" :" 
闪电 授信 ", "url":"http://www.soso.com/"}, { "type":"view","name™" : " 
快速 提现 " "uri":"http://v.qq.com/"}, 

{ "type"™ 。 人 本 全 攻 ”7 name Tr 
提升 信用 额度 " ，"key":"V1001 CREDITLIMIT"}]}, {"type":"click", "name" :" 
我 " 7 "key" : VODOL ME" } 7 { "type" : kon el ad "name" 。 nr 


更 多 服务 " r "key" : "V1 001 MORES ERVICES"™ }] } } 


















































删除 接口 返回 : 





{"errcode":0,"errmsg":"ok"} 


5.2 ”上传 下 载 多 媒体 文件 


多 媒体 文件 往往 较 大 ， 公 众 号 发 给 微 信服 务 器 ， 微 信服 务 器 再 转发 给 用 户 ， 速 度 会 很 慢 ， 影 响 用 户 体验 ， 而 且 往 往 文件 会 发 送 给 很 多 用 户 ， 每 次 上 传 或 者 下 载 就 显得 没有 必要 。 一 次 上 传 到 微 信 服务 
器 ， 获 得 文件 的 全 局 唯一 ID， 以 后 只 要 告诉 微 信服 务 器 发 给 用 户 某 ID 的 文件 ， 减 少 了 环节 ， 还 不 受 开发 者 自身 服务 器 带宽 的 限制 ， 很 好 地 提升 了 用 户 体 验 。 但 开发 者 不 要 高 兴 得 太 早 ， 微 信服 务 器 只 会 为 我 
们 保存 3 天 ， 三 天 后 就 会 自动 删除 ， 毕 竟 存 储 不 是 免费 的 ， 地 主 家 也 没有 余粮 啊 。 


5.2.1 ”上传 多 媒体 文件 


1. 接 口 说 明 


微 信 公 共 平 台 将 语音 、 图 片 、 视 频 这 些 大 体 量 的 文件 称 为 多 媒体 文件 ， 这 些 文件 都 是 以 media_id 的 形式 进行 信息 传递 。 当 公众 号 调用 接口 将 多 媒体 文件 上 传 到 微 信服 务 器 或 者 用 户 发 送 多 媒体 文件 ， 亿 
言 服务 器 都 会 返回 对 应 的 media_id， 公 众 号 此 后 可 根据 该 media_id 来 获取 多 媒体 文件 。media_id 是 可 以 复 用 的 。 本 接口 利用 HTTP POST/FORM 方 式 提 交 请 求 。 请 求 地 址 是 : 
http://file.api.weixin.qq.com/cgi-bin/media/upload?access token=ACCESS TOKEN&type=TYPE。 


参数 说 明 见 下 表 : 
参 数 是 否 必 须 说 明 
调用 接口 凭证 


access token 


媒体 文件 类 型 ， 分别 有 图 片 (image ) 、 语 音 (voice ) 、 视 频 ( Video ) 
和 缩 略 多 (thumb ) 


蝗 
丘 
己 . 
AE 
Media form-data 中 媒体 文件 标识 ， 有 filename 、filelength 、content-type 等 信息 


其 中 access token 和 type 是 在 url 中 传递 的 ， 而 media 则 是 通过 表单 提交 的 


type 


需要 注意 的 是 上 传 的 多 媒体 文件 有 格式 和 大 小 限制 : 

.图片 (image) : 128KB， 支 持 JPG 格 式 

. 语音 (voice) : 256KB， 播 放 长 度 不 超过 60s， 支 持 AMR\MP3 格 式 
. 视频 (video) : 1MB， 支 持 MP4 格 式 

- 缩 略 图 (thumb) : 64KB， 支 持 JPG 格 式 


如 果 上 传 thumb 文 件 ， 返 回 的 JSON 数 据 结 构 是 : 





{"type":"thumb", "thumb media id":"MEDIA ID","created at":123456789} 

















如 果 上 传 的 是 其 他 类 型 的 多 媒体 文件 ， 返 回 的 JJON 数 据 结构 是 : 








{"type":"TYPE", "media id":"MEDIA ID","created at":123456789} 




















2. 接 口 封 装 


具体 代码 如 下 : 


大 
上 传 多 媒体 
* Qparam {string} $type 
* Qparam {string} $file path 
* Qparam {int} SmediaidOnly 
* Qreturn null 
*/ 
public static function upload( $type, $file path){ 
Saccess token = self::getToken (); 
$url = "http: //file.api.weixin.dqggq. com/cgi-bin/media/upload?access token=$access tokeng&type=$type"; 
$ret = curl post( $url, array( 'media' => "@s$file path™" ) ); 
$ret = json decogde( $ret, true ) ， 
if( self::getResult( $ret) )f{ 
return $type == 'thumb' ? $ret['thumb media id'] : $ret[l'media id']; 







































































} 


return null; 


} 


private function testUpload() 

















$ret = self::upload('image', 'location.jpg'); 
$this->outputText ("type : image\nmedia id : ".S$ret); 





5.2.2 下 载 多 媒体 文件 


1. 接 口 说 明 


如 果 公 众 号 想 获 取 多 媒体 文件 可 以 通过 本 接口 实现 。 注 意 ， 视 频 文件 不 支持 下载。 该 接口 使 用 HTTP GET 方 式 提交 请 求 ， 请 求 地 址 是 : http://file.api.weixin.qq.com/cgi-bin/media/get? 
access token=ACCESS TOKEN&media id=MEDIA ID。 


下 载 完 成 后 ， 我 们 需要 将 文件 保存 起 来 ，SAE 提 供 了 存储 服务 Storage， 利 用 它 开放 的 API 可 以 将 文件 存 到 SAE 中 ， 如 下 图 所 示 。 


< 
应 用 信息 
涉 .总 术 县 
预 复 设 首 
资源 报表 
服务 状态 
应 用 管理 
应 用 看 叶 
成 只管 理 
避 三 营 理 
营利 记 也 
应 用 防 淡 塔 
Appconfig 
应 用 调 优 
预定 改变 量 
月 入 申 心 
AHProf 
应 用 体格 alpha 


Memcache 
Cron 
Image 
FeichURL 


| huoyaxiaotu > 服务 管理 » -Storage 


| storage 管理 | Storage 防 淡 载 


Storage 简介 


rage 是 SAE 为 开 扣 者 提 人 世 的 车 布 式 区 件 存 铺 服 务 ， 
来 存放 用 户 的 持 志 化 存 铺 的 芝 件 用户 需要 上 先 在 社 上 昧 
党 理 平 癌 人 | 津 Domain “相当 于 一 角子 月 录 1 ， 创 建 完 
毕 后 : 即 可 进行 区 件 的 宫 理 。 伞 奢 使 用 况 明 青 点 击 访 里 
”查看 。 
上 传 六 区 件 请 驳 考 庆 文 旨 


半 f 奸 domain 


Domain 管 理 


Domain Name 访问 权限 。 前 介 防盗 链 ”操作 


转 huoyaxiaotu public 省 汪 小 名 百 管理 修 避 属性 星际 


试 为 不 开启 了 防盗 购 功 能 。 如果 您 林寺 村 此 功能 可 忆 通 过 "修改 
属性 性 接 取 消防 训 尾 : 
2 开放 资 糙 功 能 后 ; 您 雪 要 把 多 许 访问 怎 Sterage 交 件 的 域名 添加 
肥 白 名 单列 表 ， 百 则 访问 时 会 返回 和 3 模 呈 。 
3 开启 防盗 链 功 能 后 ; 如 果 浆 没有 填写 性 何 的 将 许 访问 或 名; 那 过 
所 有 的 请 求 都 会 被 拒绝 。 

“ 直 共 有 Deomain 的 数据 可 直接 通过 互联 网 访 间 ， 隐 笠 娄 据 甫 保存 关 
数据 库 或 者 KVDB 





SAE Storage 有 个 域 的 概念 ， 可 以 理解 为 一 级 目录 ， 是 对 外 管理 的 单位 ， 同 一 域 下 面 的 所 有 目录 拥有 相同 的 属性 (访问 权限 和 防盗 链 ) 。 


SAE Storage 提 供 了 php 类 SaeStorage， 所 有 的 读 写 访问 接口 都 包含 在 里 面 。API 文 档 位 于 : http://apidoc.sinaapp.com/sae/SaeStorage.html。 


写 文件 接口 如 下 : 


string write (string $domain, string $destrFileName, string $content, [int $size = -1], 


参数 说 明 如 下 : 


$size: 写 入 长 度 ， 默 认为 不 限制 。 








2 .接口 封装 
具体 代码 如 下 所 示 : 


/** 
下 载 多 媒体 内 容 


. $dqomain: 存储 域 ， 这 里 就 huoyaxiaotu。 
. $destFileName: 文件 名 ， 包 含 域 下 面 的 目录 路 径 。 


“ $content: 文件 内 容 ， 支 持 二 进 制 数据 。 


$atttr: 文件 属性 ， 可 设置 的 属性 参考 SaeStotage: : setFileAttr () 方法 。 


* Qparam {string} $media id 


* Qreturn type 


*/ 





public static function download( $media iqd ) { 














$access token = self::getToken (); 

















[array Sattr = array()], [pool $compress = false]) 


$compress: 是 否 用 gzip 压 缩 。 如 果 设 为 tue， 则 文件 会 经 过 gzip 压 缩 后 再 存 入 Storage ， 常 与 $attr=atrray ('encoding' 二 >'gzip') 联合 使 用 。 


$url = "http://file.api .weixin.gqq.com/cgi-bin/media/get?access token={$access token}&media id={$media id}"; 





$ret = curl get( $url ) 
$s = new SaeStorage(); 





return $s->write ("huoyaxiaotu","/image/download.jpg", $ret); 


5.2.3 ”测试 案例 


上 传 图 片 我 们 需要 先 将 多 媒体 文件 上 传 到 SAE 服 务 器 中 ， 上 传 后 得 到 media_id。 然 后 根据 media_id 将 图 片 下 载 下 来 并 存 到 SAE 里 ， 得 到 图 片 的 链接 。 








private function testDownload() 




















$ret = self::download('dHhva6uzRyAfZrJ4JQ772e22-IZcZRX9eSazEhHo37oIxIYfS9vSpfYxUPyNOxDLF'); 



































Sthis->outputText ("type : image\npath in SAE Storage : ".S$ret); 





上 传 图 卢 





media_id : 
dHhva6uzRyAfZrJ4JQ7Ze22- 
IZcZRx9esazEhHo37olxIYfS9vSpfY 
xUPyNQxDLF 





“type :image 
path In SAE Storage : http:// 
huoyaxiaotu- 
huoyaxiaotu. stor.sinaapp.com/ 
image/download jpg 








5.3 ”用户 管理 


在 第 1 章 中 ， 我 们 介绍 了 通过 微 信 公共 平台 管理 平台 进行 用 户 管理 ， 查 看 用 户 的 基本 信息 ， 给 用 户 分 组 ， 但 这 些 都 是 基于 手动 的 操作 ， 比 较 烦 琐 。 而 且 用 户 管理 最 大 的 用 处 是 能 与 开发 者 自己 的 后 端 平台 
进行 对 接 ， 用 户 管理 接口 为 针对 用 户 的 基本 信息 提供 个 性 化 服务 提供 了 强大 的 支持 。 


5.3.1 ”管理 分 组 
微 信 公 共 平 台 可 以 对 用 户 进行 分 组 ， 便 于 管理 用 户 。 分 组 管理 接口 可 以 对 分 组 进行 查询 、 创 建 、 修 改 操 作 ， 也 可 以 在 需要 时 将 用 户 移 动 到 某 个 分 组 。 


1. 查 询 分 组 


(1) 接口 说 明 


通过 查询 分 组 接口 可 以 获得 所 有 分 组 列表 ， 该 接口 使 用 HTTPS GET 方 式 提交 请 求 ， 接 口 地 址 是 : https://api.weixin.qq.com/cgi-bin/groups/get?access token=ACCESS TOKEN。 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


























"groups™: [ 
"iad: 0 
"name": " 
未 分 组 "， 
"count": 72596 
}, 
{ 
id 7 
mame" : 
黑 名 单 "， 
GOUuntE 二 .36 
}, 
{ 
os 2 
mame" : 
星 标 组 "， 
‘ount: 8 
}, 
{ 
id": 104, 
mame" : 
华东 媒 "， 
"Count": 4 
}, 
{ 
"id"™ .L106; 
"name": " 
克 不 测试 组 友 "， 
"count": 1 
} 
] 
} 
参数 说 明 见 下 表 : 
参 数 计 明 
省 国生 = 闫 万 
eroups 公众 平台 分 组 信息 列表 
- /"\ 产 4 山 和 古 耳 
1d 人 组 ID 9 中 做 fi 1 他 由 C 
汪汪 了 iE 
name 分 组 名 了 字 ，UTF8 编 公 
A 六 1 
count 分 组 内 用 户 数 量 


如 果 不 正确 ， 返 回 的 JSON 数 据 包 示 例如 下 (以 ApplD 无 效 为 例 ) : 
{"errcode":40013, "errmsg":"invalid appid"} 

(2) 接口 封装 

具体 代码 如 下 : 


/** 
友 


查询 所 有 分 组 





* Qreturn type 
SY 
public static function getAllGroups () { 
$access token = self::getToken (); 
$url = self::API URL . "/cgi-bin/groups/get?access token={$access token}"; 
( 


























Scontent = curl get( Surl ); 
$content, true ); 
return self::getResult( $ret ) ? urldecode ($content) : null; 





























2. 创 建 分 组 


(1) 接口 说 明 


一 个 公共 账号 ， 最 多 支持 创建 500 个 分 组 。 利 用 HTTPS POST 的 方式 提交 申请 ， 接 口 地 址 为 : https://api.weixin.qq.com/cgi-bin/groups/create?access token=ACCESS_ TOKEN。 
提交 的 JSON 数 据 格式 如 下 : 
{"group": {"name":"test"}} 


创建 一 个 名 为 “test” 的 分 组 ,分 组 的 名 称 要 在 30 个 字符 以 内 。 正 常情 况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


"Group :. 1 
uo L077 
"name": "test" 


“test” 分 组 的 id 是 107， 注 意 创 建 分 组 允许 重 名 ， 但 有 不 同 的 ID， 原 则 上 要 避免 创建 名 字 相 同 的 分 组 。 如 果 创 建 不 成 功 ， 以 ApplD 无 效 错误 为 例 ， 返 回 如 下 代码 : 
{"errcode":40013, "errmsg":"invalid appid"} 

(2) 接口 封装 

具体 代码 如 下 : 


/** 
大 


创建 分 组 


* Qparam {string} Sname 





* Qreturn type 
*/ 
public static function createGroup( Sname ){ 
$access token = self::getToken (); 
$url = self::API URL . "/cgi-bin/groups/create?access token={Saccess token}"; 
$content = curl post( $url, json encode (array ( 
'group' => array( 'name' => urlencode (Sname) ) 
) ) ); 
$ret = json decode( $content, true ); 
return self::getResult( $ret ) ? urldecode ($content) : null; 












































这 里 要 注意 的 是 json_encode 编 码 中 文 会 出 现 乱 码 问题 ， 解 决 方法 是 在 用 son_encode 编 码 之 前 先 用 urlencode 编 码 ， 获 取 的 时 候 也 要 记得 用 urldecode 解 码 ， 这 样 就 能 正常 处 理 中 文 了 。 


3. 移 动用 户 分 组 


(1) 接口 说 明 


移动 所 用 分 组 是 根据 用 户 的 Openid 将 用 户 移 到 指定 分 组 。 利 用 HTTPS POST 方式 提交 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/groups/members/update? 
access token=ACCESS TOKEN。 


提交 的 JSON 数 据 格式 ， 将 用 户 移动 至 groupid 为 108 的 分 组 : 





{"openid":"oDF3iYx0ro3 7jD4HFRDfrjAdCM58", "to groupid":108} 
正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 
{"errcode": 0, "errmsg": "ok"} 


(2) 接口 封装 
具体 代码 如 下 : 


/** 


大 
移动 用 户 分 组 
* Qparam type Sopenid 
户 唯 一 标识 符 
* Qparam type S$gid 
分 组 id 
* Qreturn type 
7 
public static function moveUserByld( S$openid, S$giqd ){ 
$access token self::getToken (); 
$url=self::API URL . "/cgi-bin/groups/members/update?access token={$access token}"; 
$ret = curl post( 
SU 
json encode ( 
array ( 
'openid' => Sopenid， 
'to groupid' => $gid 










































































) 
); 
$ret = json decode( $ret, true ); 
return self::getResult( $ret ); 











4. 查 询 用 户 所 在 分 组 
(1) 接口 说 明 
通过 用 户 的 Openid 查 询 其 所 在 的 groupid。 利 用 HTTPS POST 方式 提交 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/groups/getid?access token=ACCESS TOKEN。 


提交 的 JSON 数 据 格式 : 





{"openid" :"odq8XI]J smk6QadqVITETa9]jLLGWNA6KBc" } 











正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


{"groupid": 102} 





(2) 接口 封装 


具体 代码 如 下 所 示 : 





/** 


大 
查询 用 户 所 在 分 组 
* Qparam type Sopenid 
用 户 唯一 标识 符 
* Qreturn type 
*/ 
public static function getGroupidByOpenid( S$openiqd ){ 
$access token = self::getToken(); 
$url = self::API URL. "/cgi-bin/groups/getid?access token={$access token}"; 
$ret = curl post( $url, json encode( array( 
'openid"' => Sopenid 
) ) ); 
$ret = json decode( $ret, true ); 
return self::getResult( $ret ) ? $ret[l'groupid'] : null; 
























































5. 修 改 分 组 名 
(1) 接口 说 明 
根据 分 组 的 groupid 修 改名 称 。 利 用 HTTPS POST 方式 提交 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/groups/update?access token=ACCESS TOKEN。 


请 求 的 JSON 数 据 格 式 ， 将 groupid 为 108 的 分 组 ， 重 命名 为 test2_ modify2: 








{"group": {"id":108, "name":"test2 modify2"}} 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


{"errcode": 0, "errmsg": "ok"} 





(2) 接口 封装 
具体 代码 如 下 所 示 : 


/** 


大 
修改 分 组 名 
* Qparam type S$gid 
分 组 idq 
* Qparam type Sname 
分 组 名 字 
* Qreturn type 
7 
public static function renameGroup( S$gid, $name ){ 
$access token = self::getToken(); 
$url = self::API URL . "/cgi-bin/groups/update?access token={Saccess token}"; 
$ret = curl post( $url, json encode (array( 
'group' => array( - 
rid' => $gigd, 
'name' => urlencode ($name) 



































yr 
$ret = json decode( $ret, true ); 
return self::getResult( $ret ); 








6. 测 试 案例 


测试 案例 的 具体 代码 如 下 : 








private function testGroupManage ($data) 











if (S$this->isTextMsg ()) 


Switch ($data->Content) 
{ 




















Case ' 
创建 分 组 ': 
Sret = self::createGroup('" 
供应 商 ')，; 
$this->outputText ($ret); 
break; 
Case ' 
分 组 列表 ' : 
$ret = self::getAllGroups () ; 
Sthis->outputText ($ret); 
break; 
Case ' 
用 户 所 在 分 组 ' : 














$ret = self::getGroupidByOpenid('ogl7nt6kNCcqgq25b77C8L2zEJXdO'); 
Sthis->outputText (" 











分 组 ' .Sret) ; 
break; 
ase ' 


C 
移动 用 户 分 组 ' : 

















break; 
case ' 














修改 分 组 名 
se name ( 
Sr 1f: () 
$sthis->outputText ( 
重 命 名 101 
分 组 :' .Sret) 
break; 
} 
} 
} 





{"groups":[{"id":0,"name":" 未 分 组 
"count"0},.{"id"1,"name":" 黑 名 单 
""count":0},{"id":2,"mname":" 星 标 组 
""count":0}{"id":100,"name"™."VIiP"."c 
ount":0}.{"id™*101,"name":"VIP""cou 
nt jd 102 "name" 同事 
“count':0f id :103name": "供应 商 


""count":0}]} 
创建 分 组 EE 


{"group"{"id":104,."name”"" 供 应 商 ")} 


修改 分 组 名 上 

















重症 名 101 邦 

组 :fgroups" sf id":0"name"." 未 分 组 

"count"“0} {id":1,"name" " 黑 名 单 

“count"“0} "id"2."name"" 星 标 组 

""count"0} {"id":100,"name"."VIP""c 
OUuUnmt DO 人 id“ 1012"nmarme” 客户 
”Count 1 ("id"102"name" 同 事 
"“"count"0} ("id"103,"name"" 供 应 商 
"count™*0} ("id"*104,"name"" 供 应 商 
" "count":0}]} 








移动 用 户 分 组 








动用 户 到 102 分 组 


用 户 所 在 分 组 








5.3.2 ”获取 用 己基 本 信息 


1. 接 口 说 明 


在 关注 者 与 公众 号 产生 信息 交互 后 ， 公 众 号 可 以 获得 关注 者 的 Openld (加 密 后 的 微 信 号 ， 每 个 用 户 对 每 个 公众 号 的 Openld 是 唯一 的 ， 对 于 不 同 公众 号 ， 同 一 用 户 的 Openld 不 同 ) 。 公 众 号 可 以 通过 
本 接口 的 Openld 获 取 用 户 的 基本 信息 ， 包 括 上 昵称、 头像、 性别、 所 在 城市 、 语 言 和 关注 时 间 。 利 用 HTTPS GET 方 式 提 交 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/user/info? 
access token=ACCESS TOKEN&.openid=OPENID&lang=zh _ CN, 


其 中 lang 是 可 选项 ， 返 回国 家 地 区 语言 版 本 ， 选 项 包括 : zh_CN 简 体 、zh_TW 繁 体 、en 英 语 。 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


"subscribe": 1, 
"openid": "o6 bmjrPTlm6 2sgVt7hMZOPfL2M"， 
"nickname" : "Band", 加 
Vsex ts 1 
"language": "zh CN", 
VolEy 1 
广州 "， 


"province": " 








区 
"country": " 
T 





"headimgurl": 
"http://wx.qlogo.cn/mmopen/g3MonUZtNHkAdmzicIlibx6iaFgqAc56vxLSUfpb6nNSWKSYVYOChOKkiaJSgQ1ldZuTOgvLLrhJbPERQOA4eMsv84eavHiaiceqxibJxCfHe/0", 
"subscribe time": 1382694957 























参数 说 明 见 下 表 : 
参 数 说 明 
subscribe 用 户 是 否 订 阅 该 公众 号 标识 ， 值 为 0 时， 代表 此 用 户 没有 关注 该 公众 号 ， 拉 取 不 到 其 余 信息 ， 
nickname 用 户 的 昵称 
sex 用 户 的 性 别 ,， 值 为 1 时 是 男性 ， 值 为 2 时 是 女性 ， 值 为 0 时 是 未 知 
city 用 户 所 在 城市 
country 用 户 所 在 国家 
province 用 户 所 在 省 份 
laneuage 用 户 的 语言 ， 人 向 体 中 文 为 zh_CN 


用 户头 像 ， 最 后 一 个 数值 代表 正方 形 头 像 大 小 (有 0、46、64、96、132 数 值 可 选 ，0 代 表 


headimeurl a ee a 
640 x 640 正 方形 头像 ) ， 用 户 没有 头像 时 该 项 为 空 


subscribe time 用 户 关 注 时 间 ， 为 时 间 戳 。 如 果 用 户 和 曾 多 次 关注 ， 则 取 最 后 关注 时 间 


2. 接 口 封装 


具体 代码 如 下 : 


















































/** 
大 
获取 用 户 基 本 信息 
* QQparam type Sopenid 
普通 用 户 的 标识 ， 对 当前 公众 号 唯 
* Qparam string $lang 
返回 国家 地 区 语言 版 本 ，zh CN 
简体 ，zh TW . 
繁体 ， en 
英语 








* Qreturn type 
A 




















public static function getUserInfoById( $openid, $lang="'zh CN' ){ 








if( !$lang ) $lang = 'zh CN'; 











Saccess token Sel]| 
Surl=self::API URL . 














: :getToken (); 
"/cgi-bin/user/info?access token=$access token&openid={$openid}&lang={$1lang}"; 








$content = curl get( $url ); 
$ret = json decode ($content, true ); 














return self::getResult( $ret ) ? S$content : null; 


} 


3. 测 试 案例 


测试 案例 的 具体 代码 如 下 : 











public function processReque 
sae log(var export($ 























$re self: :getUser 





st($data) { 
data, TRUE) ) ， 














$sthis->sendmsg = new SendMsgDB () 








(); 
nfoById ('ogl7nt6kNCcqq25b77C8L2zEJXdO'); 

















} 


最 终 效 果 如 下 图 所 示 : 


sthis->outputText ($ret); 


a 


La ] 





和 音 词 用 户 信 息 





{"subscribe":1,"openid":"og17nt6kN 
Ccqq25b77C8L2zEJXdQ""nicknam 
e"-" 周 涛 
"sex":l,"language”:"zh_CN",city":" 
苏州 ""province"" 江 苏 ""country"" 中 
国 ""headimgurl":"http:VV 
wx.ologo.cnVvmmopenV 
ajNVdqHZLLD1UoU85gC099II14gz 
WwWFI1XxIcICIauUCwqv4kxBB9pyFvwz2b 


pp | PP EN 





[BU T YYYY LUFTUIdANUCY 
USOmkAVO""subscribe time" :1398 
501375) 


只 


2 | “授信 \ 提 现 , 和 更 多 服 











5.3.3 ”获取 关注 者 列表 


1. 接 口 说 明 


/4 


公众 号 可 以 通过 本 接口 来 获取 账号 的 关注 者 列表 ， 关 注 者 列表 由 一 串 Openld 组 成 。 一 次 拉 取 调用 最 多 拉 取 10000 个 关注 者 的 Openld， 可 以 通过 多 次 拉 取 来 获取 所 有 关注 者 列表 。 利 用 HTTPS GET 方 式 
提交 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/user/get?access token=ACCESS TOKEN&next openid=NEXT OPENID。 


其 中 next_openid 是 第 一 个 拉 取 的 Openld， 黑 认为 从 头 开 始 拉 取 。 正 常情 况 下 ， 微 信 会 返回 下 述 JSJON 数 据 包 : 






































{"total":2,"count":2,"data": {"openigd": ["", "OPENTD1"， "OPENID2"] }, "next openid" :"NEXT OPENID"} 


\ 


参 数 说 。 朋 


total 关注 该 公众 账号 的 总 用 户 数 
pi 拉 取 的 OPENID 个 数 ， 最 大 值 为 10000 


data 列表 数据 ，OPENID 的 列表 


next openid 拉 取 列表 的 后 一 个 用 户 的 OPENID 


如 果 关 注 者 数量 超过 10000， 在 调用 接口 时 ， 将 上 次 调用 得 到 的 返回 中 的 next_openid 值 作为 下 一 次 调用 中 的 next openid 值 ， 循 环 调用 直到 next_openid 的 值 为 空 。 


2 .接口 封装 
具体 代码 如 下 所 示 : 


/** 


获取 关注 者 列表 

* Q@param type Snext id 
第 一 个 拉 取 的 OPENID 
， 不 填 默 认 从 头 开始 拉 取 


* Qreturn type 
大 


























public static function getUserList( Snext id= '" ){ 
$access token self::getToken (); 
$extend = "''} 
if( !empty(Snext id) ){ 
$extend = "&next _ openid=Snext id"; 




















} 
$url = self::API URL . "/cgi-pbin/user/get?access token={$access token}$extend"; 
$content = curl get( $url ); 

$ret = json decode ($content,true); 





























return self::getResult( Sret ) 
? array( 
'total' => $ret['total'], 
'count'=> $ret['count"'], 
lJist'=> $ret['data']['openid"'], 
'next id' => isset( $ret['next openid'] ) ? $ret[l'next openid']: null 


























我 们 发 现 获 取 完 关 注 者 列表 得 到 的 返回 JSON 结 构 中 next_openid 并 不 是 空 ， 而 是 openid 列 表 中 的 最 后 一 个 openid。 开 发 者 在 实际 开发 中 请 注意 。 据 此 ， 判 断 结束 可 以 使 用 两 个 条 件 : next_openid 不 
为 空 或 者 next_openid 不 是 openid 列 表 中 的 最 后 一 个 。 判 断代 码 如 下 : 


Snext id != null || Snext id != end(s$ret[']list'] 
3. 测 试 案例 


测试 案例 如 下 代码 所 示 : 





private function testGetUserList () 


{ 











$ret = self::getUserList () ， 
Snext id = $ret[l'next id']; 


$this->outputText (json encode ($ret)); 

















} 


最 终 效 果 如 下 图 所 示 : 


13:58 


( 略微 信 公 众 平台 测试 号 





用 尸 列 表 





{total :1 count :1 list |"og17nt6kN 
Ccqq25b77C8L2zEJXdQ"] next_id”: 
"0g17nt6KkNCcqq25b77C8L2zEJXd 
QO"} 
































5.4 ”获取 用 户 地 理 位 置 


服务 号 相对 订阅 号 另 一 个 非常 有 价值 的 功能 是 可 以 自动 获取 用 户 的 地 理 位 置 ， 而 不 用 用 户 手动 发 送 ， 当 然 需 要 用 户 的 同意 。 这 为 公众 号 针对 位 置 提 供 个 性 化 服务 提供 了 方便 ， 比 如 出 门 问 问 ， 青 比如 某 
家 实体 店 的 公众 号 可 以 向 用 户 推 荐 最 近 的 门店 ， 给 出 导航 信息 。 首 先 公 众 号 需要 开启 获取 用 户 地 理 位 置 服务 ， 如 下 图 所 示 。 





有 两 个 选项 ， 一 种 是 每 次 用 户 进 入 会 话 时 ， 上 报 一 次 地 理 位 置 ， 还 有 一 种 是 在 进入 公众 号 后 ， 每 隔 5s 发 送 一 次 ， 如 果 退 出 公众 号 将 不 再 上 传 地 理 位 置信 息 。 


用 户 关注 了 已 开启 上 报 地 理 位 置 接口 的 公众 号 后 ， 首 次 进入 公众 号 会 话 时 ， 会 弹出 提示 框 让 用 户 确认 是 否 允 许 公 众 号 使 用 其 地 理 位 置 。 提 示 框 只 在 关注 后 出 现 一 次 ， 用 户 以 后 可 以 自行 在 公众 号 详情 页 
面 进行 操作 。 




















出 | 加 上 I 加 要 求 使 用 你 的 地 于 位 和 直 ， 


是 百人 多 计 ? 


取消 确 


对 上 传 地 理 位 置信 息 的 处 理 ， 已 在 第 4 章 介 绍 过 ， 这 里 不 再 歼 述 。 





5.5 OAuth2.0 网 页 授权 


我 们 知道 微 信 公 众 号 自 定 义 菜单 有 两 种 类 型 的 按钮 : click 和 view。 点 击 click 类 型 按钮 ， 产 生 与 公众 号 的 互动 ， 点 击 view 类 型 的 按钮 直接 跳 转 到 第 三 方 网 页 (一 般 是 公众 号 的 管理 后 台 ) 。 一 个 很 基本 的 
需求 是 希望 了 解 当前 打开 网 页 的 用 户 是 谁 ?但 很 明显 通过 view 打 开 的 网 页 不 具备 这 个 能 力 ， 因 为 URL 中 不 携带 任何 关于 用 户 的 信息 。 有 一 种 变通 的 方案 是 通过 click 按 钮 实现 ， 用 户 点 击 click 按 钮 ， 公 众 号 返 
回 带 有 URL 的 一 段 信息 ， 这 个 URL 因 为 是 在 后 台 生 成 的 ， 所 以 可 以 利用 前 面 提 到 的 获取 用 户 基本 信息 接口 ， 将 用 户 基 本 信息 附加 在 URL 中 ， 这 样 用 户 打 开 的 网 页 就 能 获知 用 户 的 基本 信息 了 。 如 招行 信用 卡 公 
众 号 就 采用 了 这 种 方案 ( 见 下 图 ) : 





和 您 可 使 用 招行 请 工农 中 建 蔡 邮 人 鲍 
光 六 村 1 ] 汪汪 全 J 日 lee 征 









和 
i = 需 事先 开通 "银联 在 线 支付 
业务 " 





担心 夸 记 还 秋 哆 ? 和 您 可 指定 名 下 我 行 
一 卡通 ,自动 为 信用 卡 还 寺 








[1 |] 外币 交易 还 不 款 

[2 快速 还 款 注意 事项 
[3 引 查 询 更 多 还 款 方 式 
[ 必 更 多 服务 





本 二 = 可 | 
i 
| 人 


( 约 招商 银行 手机 银行 网 页 版 





手机 转账 D 费用 , 享 写 年 ! 
每 日 衫 度 20 万 ， 更 才 功 能 下 载 客户 端 





卡通“ 时 时 站 :下 





登录 方式 : CQ 证 件 卡号 


下 写 : 








附加 码 : 4158 














这 种 方案 能 满足 我 们 的 要 求 ， 但 不 够 直接 ， 没 能 充分 利用 view 按 钮 的 作用 。 如 果 想 在 view 按 钮 跳 转 的 网 页 中 获取 用 户 的 基本 信息 ， 可 以 做 到 吗 ” 答 案 是 可 以 的 。 微 信 公 共 平 台 给 开发 者 提供 了 
OAuth2.0 授 权 接 口 。 


OAuth2.0 授 权 协 议 是 账号 体系 的 基础 。 我 们 在 访问 第 三 方 网 站 时 ， 经 常 被 要 求 登 录 ， 但 我 们 又 不 想 是 个 网 站 就 去 注册 个 账号 ， 于 是 很 多 网 站 就 提供 了 使 用 微 博 、QQ 账 号 登录 的 功能 ， 只 要 用 户 给 予 了 
授权 ， 我 们 就 能 获取 到 用 户 在 微 博 或 者 QQ 中 的 信息 ， 比 如 昵称 、 性 别 ， 关 注 或 者 被 关注 的 朋友 等 信息 ， 有 了 这 些 信 息 开发 者 可 以 做 很 多 事情 ， 而 这 个 过 程 的 信息 安全 就 由 OAuth2.0 协 议 保证 。 


微 信 OAuth2.0 授 权 协 议 与 之 类 似 ， 通 过 微 信 OAuth2.0 授 权 ， 公 众 号 开发 者 可 以 获取 当前 用 户 的 基本 信息 (包括 昵称 、 性 别 、 城 市 、 国 家 ) 。 利 用 用 户 信息 ， 可 以 实现 体验 优化 、 用 户 来 源 统计 、 账 号 
绑 定 、 用 户 身份 鉴 权 等 功能 。 值 得 注意 的 是 ， 获 取 用 户 基本 信息 接口 时 在 用 户 和 公众 号 产生 消息 交互 时 ， 才 能 根据 用 户 OpenlD 获 取 用 户 基本 信息 ， 而 网 页 授权 的 方式 获取 用 户 基 本 信息 ， 则 无 须 交 互 ， 只 
要 用 户 进 入 到 公众 号 的 网 页 ， 就 可 弹出 请 求 用 户 授权 的 界面 ， 用 户 授权 后 ， 就 可 获得 其 基本 信息 ， 此 过 程 甚至 不 需要 用 户 关 注 该 公众 号 。 


5.5.1 配置 授权 回调 域名 


首先 我 们 需要 在 公共 平台 网 站 的 我 的 服务 页 中 配置 授权 回调 域名 ， 即 在 微 信 公共 平台 进行 注册 ， 以 后 这 个 域名 下 的 网 页 都 能 进行 OAuth2.0 鉴 权 ( 见 下 图 ) 。 这 里 填写 的 域名 不 需要 加 http://。 授 权 回 调 
域名 配置 规范 为 全 域名 ， 比 如 需要 网 页 授权 的 域名 为 : www.qq.com， 配 置 以 后 此 域名 下 面 的 页 面 http://www.qq.com/music.html、http://www.qq.com/login.html 都 可 以 进行 OAuth2.0 鉴 权 。 但 
http://pay.qq.com、http://music.qq.com、http://qq.com 无 法 进行 OAuth2.0 鉴 权 。 


如 果 你 的 网 址 没有 被 列 入 黑 名 单 ， 就 会 在 项 部 出 现 “ 安 全 检测 中 ”、 “通过 安全 检测 ”字样 ， 表 明 域 名 配置 成 功 。 


OAuth2.0 网 页 授权 欠 


授权 回调 内 面 域 名 : 


8B.huoyaxiaotu sinaapp.com 






用 户 在 网 页 授权 页 同意 楼 权 给 公众 号 后 ， 微 信 会 交接 权 数 
一 个 回调 页 面 ， 回 调 页 面 需 在 此 域名 下 ， 以 确保 安全 可 靠 。 





























rm 


5.5.2 ” OAuth2.0 授 权 流 程 


OAuth2.0 授 权 流 程 主要 分 为 三 步 : 

1) 引导 用 户 进 入 授权 页 面 同意 授权 ， 获 得 code。 

2) 通过 code 损 取 网 页 授权 access_ token 和 openid， 这 里 前 面 提 到 的 access_token 凭 证 不 同 。 如 果 需 要 ， 开 发 者 可 以 刷新 网 页 授权 access_ token ， 避 免 过 期 。 
3) 通过 网 页 授权 access_ token 和 openid 获 取 用 户 基本 信息 。 

下 面 分 别 对 这 三 个 步骤 进行 详细 介绍 。 

1) 获取 code 


引导 关注 者 打开 页 面 : https://open.weixin.qq.com/connect/oauth2/authorize? 
appid=APPID&redirect uri=REDIRECT URI&response type=code&scope=SCOPE&state=STATE#wechat redirect。 


参数 说 明 ( 见 下 表 ) : 


参 数 是 否 必 须 说 明 
appid \ 傣 号 的 唯一 标识 
redirect uri 授权 后 重 定 问 的 回调 链接 地 址 ， 请 使 用 urlencode 对 链接 进行 处 理 
返回 类 型 ， 请 填写 code 
应 用 授权 作用 域 ，snsapi base (不 弹出 授权 页 面 ， 直 接 跳 转 ， 只 能 获取 用 户 
scope 是 openid ) ，snsapl userinfo ( 弹出 授权 页 面 ， 可 通过 openid 拿 到 上 昵称、 性 别 、 所 在 
地 。 并 且 ， 即 使 在 未 关注 的 情况 下 ， 只 要 用 户 授权 ， 也 能 获取 其 信息 ) 


#wechat redirect 是 无 论 直 接 打开 还 是 做 页 面 302 重 定 问 时 ， 必 须 带 此 参数 


response type 


Redirect_uri: 用 户 点 击 授 权 或 拒绝 后 ， 微 信服 务 器 将 向 该 地 址 发 送信 息 。 该 地 址 需要 在 前 面 配 置 的 授权 回调 域名 下 ， 比 如 http://8.huoyaxiaotu.sinaapp.com/oauth2.0.php。 


下 图 为 scope 等 于 snsapi_userinfo 时 的 授权 页 面 : 


[ed 





让 奇迹 蟹 手 


应 用 公 站 呈 酝 续 双 以 下 扫 科 : 
中 同 澡 使 用 基本 资料 登录 此 应 用 








如 果 用 户 同意 授权 ， 页 面 将 跳 转 至 redirect_uri/?code=CODE&state=STATE。 若 用 户 拒绝 授权 ， 则 重 定 向 到 redirect uri?code=authdeny &state=STATE。 注 意 code 作 为 换取 access token 的 票 


据 ， 每 次 用 户 授权 带 上 的 code 不 同 ，code 只 能 使 用 一 次 ，5 分 钟 未 使 用 自动 过 期 。 


2) 通过 code 换 取 网 页 授权 access token 


得 到 了 code， 接 下 来 我 们 就 可 以 通过 code 来 获取 access token 了 ， 这 里 的 access token 与 创建 二 维 码 、 创 建 自 定义 菜单 的 access token 不 一 样 。 这 里 的 access token 地 址 是 : 


https://api.weixin.qq.com/sns/oauth2/access token?appid=APPID&secret=SECRET&code=CODE&dgrant type=authorization code。 


参数 说 明 ( 见 下 表 ) : 
参数 是 否 必须 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


{ 
"access token":"ACCESS TOKEN", 
"expires in":7200, 和 
"refresh token":"REFRESH TOKEN", 
"openid":"OPENID", 
"scope™": "SCOPE™ 

} 









































说 朋 
公众 号 的 唯一 标识 
公众 号 的 appsecret 
填写 第 一 步 获 取 的 code 参 数 
填写 为 authorization code 





参数 说 明 ( 见 下 表 ) : 


参 数 摘 述 


access token 网 页 授权 接口 调用 凭证 ,注意 : 此 access_token 与 基础 支持 的 access_token 不 同 
expires in access_token 接 口 调用 凭证 超时 时 间 ， 单 位 〈 秒 ) 
refresh token 用 户 刷 新 access token 


-一 一 


Openid 
有 公众 号 唯一 的 openid 


Scope 用 户 授 权 的 作用 域 ， 使 用 逗号 〈, ) 分 隅 


通过 这 一 步 ， 已 经 得 到 了 用 户 的 openid， 如 果 scope 是 snsapi_ base， 授 权 的 过 程 就 此 结束 了 。 


月 户 唯 一 标识 ， 请 注意 ， 在 未 关注 公众 号 时 ， 用 户 访问 公众 号 的 网 页 ， 也 会 产生 一 个 ) 


日 户 和 


由 于 access token 有 效 期 较 短 ， 如 果 access token 超 时 了 ， 可 以 使 用 refresh_token 进 行 刷 新 ，refresh_token 有 效 期 较 长 (分 为 7 天 、30 天 、60 天 、90 天 ) ， 如 果 refresh token 也 失效 了 ， 需 要 用 户 


重新 授权 。 请 求 地 址 为 : https://api.weixin.qq.com/sns/oauth2/refresh token?appid=APPID&grant type=refresh token&refresh token=REFRESH TOKEN。 


反 回 结果 与 申请 access token 的 结构 一 样 。 就 不 再 乾 述 了 


3) 拉 取 用 户 信息 


已 经 拿 到 access token 和 用 户 的 openid， 现 在 可 以 拉 取 用 户 的 信息 了 。 请 求 地 址 是 : https://api.weixin.qq.com/sns/userinfo?access token=ACCESS TOKEN&openid=OPENID&Iang=zh_CN。 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 





"openid":" OPENID", 

" nickname": NICKNAME, 
"sex™ i "1" 
"province": "PROVINCE" 
人 
GeuntEEy : "COUNTRY", 
"headimgurl": 
"nttp://wx.qlogo.cn/mmopen/g3MonUZtNHkAdmzicIlibx6iaFqAc56vxLSUfpb6nSWKSYVYOCNOKKiaJSgQ1ldZuTOgvLLrhJPEROO4eMsv84eavHiaiceqxibJxCfHe/46", 
"privilege":|[ 
"PR V LEGE!] 1 
PI 

] 

























































































"PRIVILEGE2" 





} 


参数 说 明 ( 见 下 表 ) : 


参 数 描 述 
openid 用 户 的 唯一 标识 
nickname 用 户 了 昵称 
sex 用 户 的 性 别 ， 值 为 1 时 是 男性 ， 值 为 2 时 是 女性 ， 值 为 0O 时 是 未 知 
province 用 户 个 人 资料 填写 的 省 份 
city 普通 用 户 个 人 资料 填写 的 城市 
country 国家 ， 如 中 国 为 CN 
nd 用 站 头像 最 后 a 代表 正方 形 头像 大 小 (有 0、46、64、96、1 
640 x 640 像 系 正 方形 头像 ) ， 用 户 没 有 头像 时 该 项 为 空 
privilege 用 户 特 权 信 息 ，JSON 数 组 ， 如 微 信 沃 卡 用 户 为 ( chinaunicom ) 


5.5.3 ”代码 实现 


1. 创 建 授权 链接 


数值 可 选 ，0 代 表 





/** 


* 

获取 用 户 授权 code url 
* Q@param type $scope 

授权 作用 域 :snsapi base or snsapi userinfo 
, Te $state 


sta 
a 以 人 尖 a-zA-20-9 


























* Qreturn type 
*/ 








public static function createCodeUrl ($scope, Sstate) { 
$open url = 'https://open.weixin.ggq.com'; 
$redirect Url = urlencode('http://8.huoyaxiaotu.sinaapp.com/oauth2.php'); 














$url = $open url.'/connect/oauth2/authorize?appid=" .APPID.'&redirect uri ="'.$redirect url.'é&response type=code&scope='.$scope.'&state="'.$state.'#wechat redirect'; 





return Surl; 


注意 需要 对 redirect_url 进 行 urlencode。 
2. 获 取 access token 


/** 
大 


获取 用 户 授权 access_token 
* Qparam type $code 
人 


* Qreturn type 
*/ 
public static function getAuthToken ($code)t 
$url = self::API URL.'/sns/oauth2/access token?appidq=' .APPID.'&secret=' .APPSECRET.'&cCode="' .$code.'&grant type=authorization code'; 
$content = curl get( $url ); 
$ret = json decode ($content, true ); 
return self::getResult( $ret ) ? Sret : null; 















































3. 刷 新 access_token 





/** 
大 


刷新 用 户 授权 access_token 
* Qparam type Srefresh token 
户 刷 新 access token 一 
* Q@return type 
7 
public static function refershAuthToken ($refresh token) { 
$redirect Url = urlencode('http://8.huoyaxiaotu.sinaapp.com/oauth2.php'); 
$url = self::API URL.'/sns/oauth2/refresh token?appid=" .APPID.'&grant type=refresh token&refresh token=' .Srefresh token; 
$content = curl get( $url ); 
$ret = json decode ($content, true ); 
return self::getResult( $ret ) ? Sret : null; 























































































































4. 获 取 用 户 信息 


/** 
大 
通过 OAuth2 .0 
获取 用 户 信息 
* Qparam type S$access token 
网 页 授权 接口 调用 凭证 本 
* Qparam type S$openid 
j 户 的 唯一 标识 
* Qparam type $lang 

























































































返回 国家 地 区 语言 版 本 ，zh CN 
简体 ，zh TW 加 
繁体 ， en 
英语 
* Qreturn type 
*/ 
public static function getUserInfoByOAuth ($access token,$openid,s$lang = 'zh CN'){ 
$redirect Url = urlencode('http://8.huoyaxiaotu.sinaapp.com/oauth2.php'); 
$url = self::API URL.'/sns/userinfo?access token='.$access token.'&openid='. S$openid.'&lang="' .$lang; 
$content = curl get( $url ); 











$ret = json decode ($content, true ); 
return self::getResult( $ret ) ? Sret : null; 

















5.5.4 ”案例 


创建 授权 重 定 向 页 面 OAuth2.php。 在 该 页 面 中 根据 用 户 授 权 得 到 的 code 获 取 access token， 再 根据 access token 和 openid 来 得 到 用 户 的 基本 信息 。OAuth2.php 的 内 容 如 下 : 


<?php 

require 'lib/common.func.php'; 

require 'lib/weixin.class.php'; 

$token = weixin::getAuthToken($ GET['code']); 
































$userinfo = weixin::getUserInfoByOAuth ($token['access token'],s$token['openid']); 
?> 

<!DOCTYPE HTML> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 


























<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<title>OAuth2 
演示 </title> 
<style> 
.content{ 
border:1lpx solid #d9d9g9; 
border-radius: 15px; 



































.content Pt{ 
width:100%; 





.Content p labelt 
margin-left:10px; 

















.Content p input[ltype="text"] { 
border:1lpx solid #d9d9g9; 
margin:O0px lpx; 
width:98%; 
overflow:hidden; 











} 

</style> 

</head> 

<body> 

<div class="content"> 
<p><label>OpenID</label></p> 

<p><input type="text" readonly="readonly 
<p><label> 
昵称 </1label></p> 
<p><input type="text" readonly="readonly 
<p><label> 
性 别 </label></p> 

<p><input type="text" readonly="readonly" value="<?php if ($userinfo['sex'])echo ' 
男 ';else echo ' 
女 ';?>"/></p> 
<p><label> 
省 份 </label></p> 

<p><input type="text" readonly="readonly" value="<?php echo $userinfo['province'];?>"/></p> 
<p><label> 
城市 </label></p> 











value="<?php echo $userinfo['openid'];?>"/></p> 














value="<?php echo $userinfo['nickname'];?>"/></p> 

















































































































<p><input type= 
<p><label> 
头像 </1label></p> 
<p><inp yp 
</di 

/bod 

htm 

















https://open.welxin.qgq.com/ 
connect/oauth2/ 
authorize?appid=wxed434ef44d6810 
elesredirect_uri=http%3A%2F E28 
huoyaxiaotu.sinaapp.com%2Foauth 
2.php&response type=code&scope 
=snsapl_userinfo&state=|1#Wwechat_ 
redirect 








短信 公 庆 平 癌 出 蕊 号 


该 应 用 公仆 号 和 将 芍 到 以 下 授权 : 
| 同意 使 用 基本 资料 登录 此 应 用 


好 衣 





( 人 ”OAuth2 演 示 





OpeniD 
oglintbkNCcqq25b7irC8L2zEJXdQ 
眠 称 
周涛 


| 


头像 


http://wx.qlogo.cn/mmopen/ajlNYdqHZLLD1UoUS8S 





5.6 ”高 级 群 友 接 口 


微 信 对 群发 策略 做 了 显著 提升 : 一 是 服务 号 从 每 月 1 条 的 群发 权限 放宽 为 每 月 4 条 ; 二 是 实现 提供 了 群发 接口 ， 便 于 开发 者 实现 更 灵活 的 群 友 能 力 。 这 里 蕴 售 了 一 个 很 大 的 变动 ， 现 在 的 四 条 是 指 每 个 用 
户 每 月 最 多 收 四 条 消息 。 原 先 群发 功能 也 可 以 根据 分 组 ， 地 区 等 不 同 的 分 类 进行 针对 性 群发 ， 但 即使 只 有 部 分 人 收 到 ， 依 然 消耗 了 群发 权限 ， 现 在 变 为 从 用 户 角 度 计数 ， 使 得 公众 号 运营 者 可 以 有 针对 性 地 
发 送 群 发 消息 ， 提 供 更 个 性 化 的 服务 。 


5.6.1 ”上传 图 文 消息 素材 


1. 接 口 说 明 
如 果 要 发 送 图 文 消息 ， 首 先 需要 将 图 文 消息 上 传 到 服务 器 。 请 求 方式 是 POST， 请 求 地 址 是 : https://api.weixin.qq.com/cgi-bin/media/uploadnews?access token=ACCESS TOKEN 


POST 的 JSON 数 据 格式 如 下 : 


{ 
"articles": [ 
{ 
"thumb media idq":"qI6 Ze 6PtV7svjolgs-rN6stStuHIjs9 DidOHaj0Q-mwvBelOXCFZiq20sIU-p", 
"author"™": "xxx", 加 
"title":"Happy Day", 
"content source url":"www.qq.com", 
"content":"content", 
"digest":"digest", 
"show cover pic":"1" 



































"thumb media idq":"qI6 Ze 6PtV7svjolgs-rN6stStuHIjs9 DidOHaj0Q-mwvBelOXCFZiq20sIU-p", 
下 二 "author"™: "xxx", 
"title":"Happy Day", 
"content source url":"www.qq.com", 
"content":"content", 
"digest":"digest", 
"show cover pic":"0" 
































参数 说 明 ( 见 下 表 ) : 


Articles 

thumb media 1d 
author 

title 

content source url 
content 

digest 


show cover pic 


正常 情况 下 ， 微 信 会 返回 


下 述 JSON 数 据 包 : 


CE 
站 二 


并 


pe \ 一 
遇 | 全 | 世 


说 有明 
图 文 消息 ， 一 个 图 文 消息 文 持 1 到 10 条 图 文 
图 文 消息 缩 略 图 的 media id， 
图 文 消息 的 作者 
图 文 消息 的 标题 
在 图 文 消息 
图 文 消息 页 面 的 内 容 


原文 ” 
， 支 持 HTML 标签 


.页 四 P= 阐 议 


图 文 消息 的 摘 述 


是 否 显 示 封 面 ，1 为 显示 ，0 为 不 显示 


可 以 在 基础 支持 - 


后 的 页 面 


上 传 多 妹 体 文件 接口 中 获 各 





{ 


"七 YPe” “ "news 1 








"media id":"CsEf3ldqkAYJAU6EJ 
"created at":1391857799 














(0 














KStVDSvffUJD54vaqbThMopTD-VUXXof6ctX5 

















FI6-aYyUiQ", 








2. 接 口 封 装 





/** 


上 传 图 > 消息 











public static function uploadNews ($news) 


{ 





$access token = self: 
$url = self::API URL. 








:getToken (); 
"/cgi-bin/media/uploadnews?access token={$access token}"; 











$ret = curl 
'articles' 
) 学 
$ret = json decode( $ret, true 
return self::getResult( $ret ) 


=> Snews 











pn 
* Qparam type Snews 
图 文 消息 
* Q@param type Sthumb media :id 
图 文 消息 缩 略 图 的 medqia id 
可 以 在 基础 支持 - 
上 传 多 媒体 文件 接口 中 获得 
* Qparam type StitlLe 
图 文 消息 息 的 标题 
* Qparam type $content 
> 息 页 面 的 内 容 ， 文 持 HTML 
示 签 
































* Qparam type $author 
图 文 消息 息 的 作者 
a type $content source url 
在 图 文 消 居 区 页 面 点 击 * 阅 读 原文 “后 的 页 面 
type $digest 
图 文 消息 息 的 描述 
* Q@param type $show cover pic 
是 否 显示 封面 ，] 
为 显示 ， 0 
为 不 显示 
* Qreturn type Snews 
大 
/ 
public static 
{ 






































Sartic] 


array (); 
$articlel[' 


'thumb media id"] 
Sarticle["title"] = Stitle; 














e= 
lel 
1e[ 
Sarticle["content"] 
f(!is null ($author)) 





lis 





l 
} 


$article["author"] 











a ds 


f(!is nul] 


$articlel"content source Url"] 














post( $url, json encode( array( 


); 


? $ret['media id'] 


= Sthumb media ig; 


= $content; 


= $author; 


($content source url)) 


} 
if(!is null ($digest)) 
{ 
$article["digest"] = S$digest; 
} 
if(!is null ($show cover pic)) 
{ 





$article["show Cover pic"] 
} 


Snews []=$article; 
return Snews; 


= $show cover pic; 


:Ls 








= $content source url; 


function addNews ($news, Sthumb media id, $title,s$content, $author=null, $content source url=null,$digest=null,$show Cover pic=null) 





5.6.2 ”根据 分 组 进行 群 友 


1. 接 口 说 明 


这 里 可 以 结合 5.3 节 介绍 的 分 组 管理 接口 进 
access token=ACCESS TOKEN。 


对 不 同 的 消息 类 型 有 不 同 的 消息 格式 。 


1) 图 文 消息 ， 其 中 media id 是 通 


甬 过 上 一 小 节 上 传 图 文 消息 4 


行 更 有 针对 性 的 群发 。 使 用 POST 方式 发 送 


叶 到 的 。 


， 请 求 地 址 是 : 


https://api.weixin.qq.com/cgi-bin/message/mass/sendall? 





'filter":{ 
mw group id" 2 wr 2 1 





}， 
"mpnews" :{ 

"media idq":"123dqsqajkasq2313jnhksad" 
}, 


"msgtype":"mpnews" 





2) 文本 消息 。 








"filter™":t{ 

1 group id" * 1 2 wr 
r 
Cexts 
"content™":"CONTENT" 














}, 
"msgtype":"text" 


3) 语音 消息 ， 这 里 的 media_id 是 通过 前 面 介绍 过 的 上 传 下 载 多 媒体 文件 接口 得 到 的 。 





'filter":{ 
mw group id" : 1 2 1 





} 
"voice" :1{ 

"media id":"123dsdajkasd231jhksad" 
}, 


"msgtype":"voice" 


4) 图 片 消息 ， 这 里 的 media_id 也 是 通过 上 传 下 载 多 媒体 文件 接口 得 到 的 。 


— 





'filter":t{ 
mw group id" “ ow 2 1 





}, 
"jmage"™":{ 
"media id":"123dsdajkasd231jhksad" 


}, 
"msgtype":"image" 


5) 视频 消息 ， 这 里 的 media_id 需 通过 POST 请 求 到 下 述 接口 获得 : https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access token=ACCESS TOKEN。 


POST 的 数据 格式 如 下 ， 其 中 media_iq 通 过 上 传 下 载 多 媒体 文件 得 到 : 


{ 
"media id": "rF4AUdIMfYK3efUfyoddYRMUSOzMiRmmt lO0kszupYh SzrcWSGaheq05p lHuOTO", 


"title™: "TITLE", 
"description": "Description" 


} 



































返回 为 : 





"type":"video", 
"media id":"IhdaAOQXuvJtGzwwc0abfXnzeezfOONgPK6AQOYSND8ROYMTtTfzZbLABIOQOkQOZiv2XJCc", 


"created at":1398848981 
} 


























然后 POST 下 面 数据 ， 其 中 media id 是 上 一 步 中 得 到 的 media id: 


media id 


{ 





'filter":t{ 
1 group id" 2 ow 2 1 
} 
"mpvideo™":{ 
"media id":"IhdaAOQXuvJtGzwwc0abfXnzeezfOO0NgPK6AOQYShD8ROYMTtTfzZbLABIOkQzZiv2XJc", 























}, 
"msgtype":"mpvideo" 





参数 说 明 ( 见 下 表 ) : 


By 
ES 
训 
I 
Se 
党 
ee 
一 


vs| 一 
门 册 


filter 用 于 设 定 图 文 消息 的 接收 者 


group id 是 群发 到 的 分 组 的 group id 


广 


mpnews 是 用 于 设 定 即将 发 送 的 图 文 消 息 
media id 是 用 于 群发 的 消息 的 media_ id 


msgtype 足 群发 的 消息 类 型 ， 岁 文 消 息 为 mpnews， 文 本 消息 为 text， 语 音 为 voice， 
音乐 为 musilc ， 几 导 区 和 ia 视频 为 Video 


title 合 消息 的 标题 
description 否 消息 的 描述 
thumb media 1d 足 视频 缩 略图 的 媒体 ID 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 





"errcode":0, 
"errmsg":"send job submission success", 
"msg id":34182 

} 





其 中 msg_id 是 群发 消息 ID。 需 要 注意 的 是 ， 返 回 成 功 意味 着 任务 提交 成 功 ， 并 不 意味 着 此 时 群发 已 经 结束 ， 所 以 ， 仍 有 可 能 在 后 续 的 发 送 过 程 中 出 现 异常 情况 导致 用 户 未 收 到 消息 ， 如 消息 未 通过 审 


核 、 服 务 器 不 稳定 等 。 此 外 ， 群 发 任务 一 般 需 要 较 长 的 时 间 才 能 全 部 发 送 完 毕 ， 请 耐心 等 待 。 


2. 接 口 封 装 








群发 图 文 消息 


public function sendMassNewsByGroup ($groupid, Smedqiaid) 




















$access token = self::getToken (); 


(0 





























$url = self::API URL . "/cgi-bin/message/mass/sendall?access token= $access token"; 
$json = json encode ( 
array( 
'filter' => json encode (array('group id'=>$groupidqd)), 
'msgtype' => 'mpnews', 和 
'mpnews' => json encode(array('media id'=>$mediaid)) 


) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 














} 
/** 
大 


群发 文本 消息 
7 


public function sendMassTextByGroup ($groupid, $content) 
{ 














$access token = self::getToken(); 

$url = self::API URL . "/cgi-bin/message/mass/sendall?access token= $access token"; 

$json = json encode ( 
array( 

'filter' => json encode (array('group id'=>$groupiqd)), 

'msgtype' => 'text', 

'text' => json encode (array('content'=>$mediaid)) 


QO 
(0 
































) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 














} 
/** 
大 


群发 语音 消息 
*/ 


public function sendMassVoiceByGroup ($groupid, $mediaid) 


{ 








$access token = self::getToken (); 





























$url = self::API URL . "/cgi-bin/message/mass/sendall?access token=$access token"; 
$json = json encode ( 
array( 
'filter' => json encode (array('group id'=>$groupidqd)), 
'msgtype' => 'voice', 
'voice' => json encode(array('media id'=>$mediaid)) 


) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 














} 
/** 
汉 


We 


public function sendMassImageByGroup ($groupid, $mediaidg) 


{ 




















$access token = self::getToken(); 





























$url = self::API URL . "/cgi-bin/message/mass/sendall?access token= $access token"; 
$json = json encoae ( 
array( 
filter' => json encode(array('group id'=>$groupid)), 
'msgtype' => 'image', 
'image' => json encode(array('media id'=>$mediaid)) 


) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 














} 
/** 
大 
为 群发 视频 消息 上 传 视频 
*/ 


public function getViedoMedialdForMass ($mediaid, $title,s$description) 
{ 





























$access token = self::getToken(); 
$url = "https://file.api.weixin.gq.com/cgi-bin/media/uploadvideo?access token=$access token'" 
$json = json encode ( 加 加 
artay( 
'media id' => $mediaigqd, 





'title' => $title, 
'description' =>$description 
) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 

















} 


/** 
大 
群发 视频 消息 


public function sendMassVideoByGroup ($groupid, $mediaid) 

















$access token = self::getToken(); 























$url = self::API URL . "/cgi-bin/message/mass/sendall?access token= $access token"; 
$json = json encode ( 
array( 
'filter' => json encode(array('group id'=>$groupiqd)), 
'msgtype' => 'mpvideo', 
'mpvideo' => json encode (array('media id'=>s$mediaid)), 


) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 

















5.6.3 ”根据 OpenID 列 表 群 发 
指定 群发 的 openid 列 表 ， 接 口 与 按 群 组 发 送 类 似 。POST 数 据 中 的 filter 换 成 touser， 其 他 完全 一 样 。 如 图 文 消息 : 


{ 
"touser™":[ 
"OPENID1", 
"OPENID2" 
], 
"mpnews":1 
"media id":"123dsdajkasgd231jhksad" 
}, 


"msgtype":"mpnews" 























5.6.4 ”删除 群 友 


1. 接 口 说 明 


POST 请 求 ， 请 求 地 址 是 : https://api.weixin.qq.com//cgi-bin/message/mass/delete?access token=ACCESS TOKEN。 
POST 的 JSON 数 据 格式 是 : 


{ 
} 


"msgid":30124 
msgid 是 群发 成 功 后 ， 返 回 的 消息 ID。 删 除 群发 消息 实际 上 是 使 消息 的 图 文 详情 页 失效 ， 已 经 接收 的 用 户 ， 还 可 以 在 其 本 地 看 到 消息 卡片 ， 只 是 打 不 开 。 另 外 ， 删 除 群 发 消息 只 能 删除 图 文 消息 和 视频 
消息 ， 其 他 类 型 的 消息 一 经 发 送 ， 无 法 删除 。 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


{ 
"errcode":0, 
"errmsg":"ok" 


} 


2. 接 口 封装 


/** 
We eh 妃 


public function deleteMassMessage (Smsdid) 
{ 





























$access token self::getToken ();，; 
$url = self::API URL . "/cgi-bin/message/mass/delete?access token=$access token"; 
$json = json encode ( 

array ( 


'msgid' => $msgid 
) 
); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 

















5.6.5 “事情 推送 群 皮 结果 


1. 接 口 说 明 
公共 平台 填写 


由 于 群发 任务 提交 后 ， 群 发 任务 可 能 在 一 段 时 间 后 才 完成 ， 因 此 ， 群 发 接口 调用 时 ， 仪 会 给 出 群发 任务 是 否 提交 成 功 的 提示 ， 若 群发 任务 提交 成 功 ， 则 在 群发 任务 结束 时 ， 会 向 开发 者 在 
的 开发 者 URL 推 送 事件 。 


推送 的 XML 结构 数据 格式 如 下 : 





<xml> 

<ToUserName><! [CDATA[gh 3e8adccde292]]></ToUserName> 

<FromUserName><! [CDATA[oR5Gjjl1 eiZoUpGozMo7dbBJ362A]] ></FromUserName> 
<CreateTime>1394524295</CreateTime> 
<MsgType><! [CDATA [evert] ]></MsgType> 

<Event><! [CDATA [MASSSENDJOBFINISH] ] ></ 

<MsgID>1988</MsgID> 

<Status><! [CDATA[sendsuccess] 
<TotalCount>100</TotalCount> 
<FilterCount>80</FilterCount> 
<SentCount>75</SentCount> 
<ErrorCount>5</ErrorCount> 
</xml> 




















Event> 























]></Status> 














参数 说 明 ( 见 下 表 ) : 








参 数 说 明 
ToUserName 公众 号 的 微 信 号 
FromUserName 从 众 号 群发 助手 的 微 信和 号， 为 mphelper 
CreateTime 创建 时 间 的 时 间 惟 
MsgType 消息 类 型 ， 此 处 为 event 
Event 事件 信息 ， 此 处 为 MASSSENDJOBFINISH 
MsgID 群发 的 消 且 ID 
群发 的 绊 构 ， 为 “send success” 或 “send fail” 或 ee Re stUccess 时 ， 也 有 可 能 
因 用 FF ee 号 的 消息 、 系 统 错误 等 原因 造成 少量 用 户 接 收 ，eIr(num) 是 审核 失败 的 具 
ee 体 原 因 ， 可 能 的 情况 如 下 : 
Status ee i | 0 
err(10001), WW 涉嫌 广告 err(20001),， Nd DR err(20004), | be -会 erT(20002), /涉嫌 色情 
err(20006), /涉嫌 违法 犯罪 ER 卡 嫌 舱 诈 err(20013), /涉嫌 版 权 err(22000), Wi 涉嫌 互 推 
(互相 宣传 ) err(21000), /涉嫌 其 他 
TotalCount group id 下 的 粉丝 数 ; 或 者 openid list 中 的 粉丝 数 
过 滤 ( 过 小 是 指 特 定 地 区 、 性 别 的 过 滤 、 用 户 设 置 拒 收 的 过 滤 、 用 户 接 收 已 超 4 条 的 过 滤 
FilterCount 


SentCount 























准 秆 发 送 的 粉 经 数 ， 厚 上 蜀 上 上，FilterCount = SentCount + ErrorCount 


发 送 成 功 的 粉 


后 . 


Fr 
2 






















































































, . pp 
ErrorCount 发 闪失 败 的 粉丝 数 
2 .接口 封装 
const EVENI TYPE MASSSENDJOBFINISH="'MASSSENDJOBFINISH'; 
大 大 
E 大 
判断 是 否 是 群发 返回 事件 
* Q@return boolean 
Sy 
public function isSubscribeEvent () 
{ 
return $this-> postData->Event == self::EVENT TYPE SUBSCRIPBE; 
} 
Det AD 
5.7 ”多 客服 功能 
1. 接 口 介绍 


微 信 提供 的 多 客服 功能 ， 让 公众 
等 操作 记录 。 利 用 此 接口 可 以 开发 如 


POST 请 求 方式 ， 请 求 地 址 是 : 


POST 的 JSON 数 据 格式 如 下 : 


: 123456789, 
: 987654321, 
"OPENID", 
:Oy 
7 


"starttime" 
"engdtime" 
"openid" 
"pagesize" 
"pageingdex" 

















众 号 后 台 管理 功能 更 加 方便 。 在 需要 的 时 候 , 
“消息 记录 ，、 “工作 监控 ”、 “客服 


开发 者 可 以 通过 获取 客服 聊天 记录 接口 ， 获 取 多 客服 的 
中 效 考核 ”等 功能 。 


会 话 记 录 ， 包 括 客服 和 用 户 会 话 的 所 有 消息 记录 和 


https://api.weixin.qq.com/cgi-bin/customservice/getrecord?access token=ACCESS TOKEN。 


会 话 的 创建 、 天 闭 


人 参 数 是 否 必 须 说 了 明 
access token 是 调用 接口 凭证 
openid 匣 通 用 户 的 标识 ， 对 当前 公众 号 唯一 
starttime 是 查询 开始 时 间 ，UNIX 时 间 鹤 
endtime 是 查询 结束 时 间 ，UNIX 时 间 难 ,不 能 路 日 查询 


pagesize 每 页 大 小 ， 每 页 最 多 拉 取 1000 条 
1 a 


pageindex 查询 第 几 页 ， 从 1 开始 


TD 


正常 情况 下 ， 微 信 会 返回 下 述 JSON 数 据 包 : 


"recordlist": [ 
{ 


"worker": " testl1", 
"openid": "oDF3iY9WMaswOPWjCIp £3Bnpljk", 
"opercode": 2002, 




















WE 1400563710， 
nt 1 。 1 
你 好 ， 客 服 test1 
为 你 服务 。" 
{ 
"worker": " testl1", 











"openid": "oDF3iYWMaswOPWJjCIP f3Bnpljk", 
"opercode": 2003, 
"time": 1400563731, 


"text™": 
你 好 ， 有 什么 事情 ? 
}, 


] 








} 


参数 说 明 ( 见 下 表 ) : 


参 数 说 明 


worker 客服 账号 

openid 用 户 的 标识 ， 对 当前 公众 号 唯一 
opercode 操作 ID (会 话 状态 ) ， 具 体 说 明 见 下 
time 操作 时 间 ，UNIXH 时 间 惟 

text 聊天 记录 


操作 ID (会 话 状态 ) 定义 ( 见 下 表 ) : 


ID 值 说 明 


1000 创建 未 接 入 会 话 
1001 接 入 会 话 
1002 主动 发 起 会 话 


1004 关闭 会 话 





1005 抢 接 会 话 
2001 公众 号 收 到 消 和 县 
2002 客服 发 送 消息 
2003 客服 收 到 消息 
2. 接 口 封装 
a 








0 I 天 记录 


public function getcCustomServiceRecord ($starttime, $endtime, $pagesize, $pageindex, Sopenidq=nul1l) 
































{ 
$access token = self::getToken(); 
$url = self::API URL . "/cgi-bin/customservice/getrecord??access token=$access token"; 
$a = array( 加 加 加 
'starttime' => $starttime, 
'endtime' => $engdtime, 
'pagesize' => S$pagesize 
'pageindex' => S$pageindex 





); 
if(!is null ($openig)) 
{ 


$a['openid']=$openig; 
} 
$json = json encode ($a); 
$ret = curl post ($url, $json); 
return self::getResult( $ret ); 

















5.8 微 信 小 店 


微 信 公众 平台 本 次 更 新 增加 了 微 信 小 店 功能 ， 微 信 小 店 基 于 微 信 支 付 ， 包 括 添加 商品 、 商 品 管理 、 订 单 管理 、 货 架 管理 、 维 权 等 功能 。 
开发 者 可 以 通过 小 店 接口 来 实现 快速 开店 ， 目 前 支持 以 下 接口 : 

(1) 商品 管理 接口 

开发 者 可 通过 商品 管理 接口 ， 来 增加 商品 、 删 除 商品 、 修 改 商 品 信息 、 查 询 已 有 商品 ， 并 可 通过 接口 对 商品 进行 上 下 架 等 操作 管理 。 
(2) 库存 管理 接口 

开发 者 可 通过 库存 管理 接口 ， 来 为 已 有 商品 增加 和 减少 库存 ， 包 括 进行 与 自身 系统 或 其 他 平台 的 库存 同步 。 

(3) 邮费 模板 管理 接口 

对 于 部 分 邮费 计算 复杂 的 商品 ， 开 发 者 可 通过 邮费 模板 管理 接口 ， 来 生成 、 修 改 、 删 除 和 查询 支 持 复杂 邮费 计算 的 邮费 模板 。 

(4) 分 组 管理 接口 

对 已 有 商品 ， 开 发 者 可 通过 分 组 管理 接口 ， 对 商品 进行 分 组 管理 。 接 口 包 括 增加 、 删 除 、 修 改 和 查询 分 组 。 

(5) 货架 管理 接口 

微 信 商 户 除了 可 以 在 公众 平台 网 站 中 自 定 义 货架 外 ， 也 可 通过 接口 来 增加 、 删 除 、 修 改 和 查询 货 架 。 货 架 也 是 由 控件 组 成 的 。 

(6) 订单 管理 接口 

开发 者 可 按 订单 状态 和 时 间 来 获取 订单 ， 并 对 订单 进行 发 货 。 

(7) 功能 接口 

目前 功能 接口 暂时 只 支持 上 传 图 片 接口 一 项 。 微 信 商 户 开发 接口 中 所 有 需要 用 到 图 片 的 地 方 ， 都 需 先 使 用 上 传 图 片 接口 来 预先 获得 图 片 的 URL。 


开发 者 可 以 在 http://mp.weixin.qq.com/wiki/images/4/40/%E5%BE%AE%E4%BF%A1%E5%B0%8F%E5%BA%97API%E6%89%8B%E5%86%8C _v1.12.zip 下 载 微 信 小 店 的 APl。 


第 6 章 ” 微 信 内 置 浏 换 器 Weixin Js 接口 


根据 StatCounter 的 统计 ，2012 年 5 月 Chrome 浏 览 器 的 市 场 份额 在 全 球 范围 内 达到 33%， 首 次 超过 IE， 成 为 全 球 第 一 大 网 页 浏览 器 。Chrome 诞 生 于 2008 年 9 月 初 ， 短 短 四 年 时 间 就 击败 IE， 一 -方面 是 
由 Chrome 的 优秀 品质 决定 的 ， 如 极 快 的 速度 、 便 捷 的 书签 式 管理 和 简洁 的 界面 等 ， 另 一 方面 ， 也 与 Chrome 网 上 应 用 店 有 着 密切 关系 。Chrome 开 放 了 应 用 扩展 接口 ， 开 发 者 可 以 利用 API 开 发 插件 和 扩 
展 ， 并 提交 自己 的 Chrome 应 用 及 扩展 到 Chrome 网 上 应 用 店 ; 用 户 可 以 很 方便 地 浏览 、 搜 索 自己 需要 的 插件 或 扩展 ， 以 满足 独特 的 需求 。 


众所周知 ， 微 信 浏 览 网 页 使 用 的 是 微 信 内 置 浏览 器 (以 下 简称 微 信 浏 览 器 ) 。 值 得 关注 的 是 ， 微 信 浏 览 器 也 做 了 开放 浏览 器 API 的 尝试 。 它 内 置 了 一 个 JS 对 象 WeixinJSBridge， 通 过 WeixinJSBridge 来 
调用 微 信 客户 端的 一 些 接口 ， 比 如 实现 打开 “ 扫 一 扫 ”、 获 取 用 户 网 络 状态 、 分 享 到 朋友 圈 等 功能 。 本 章 重 点 介绍 一 下 WeixinJsBridge 开 放 的 接口 及 使 用 方法 。 
6.1 微 信 济 卜 


在 移动 App 里 ,一 般 会 有 用 于 浏览 网 页 、 打 开 文 档 等 功能 的 组 件 WebView， 它 其 实 是 内 置 的 浏览 器 控件 。 微 信也 不 例外 ， 而 且 它 的 WebView 功 能 更 为 强大 ， 以 至 于 可 以 称 之 为 微 信 浏览 器 。 


读者 可 以 拿 出 手机 ， 用 微 信 “ 扫 一 扫 ” 下 面 的 二 维 码 。 





你 会 看 到 ， 这 是 本 书 的 一 个 介绍 页 。 


微 信 浏 览 器 支持 了 常见 的 HTML 5 特性 ， 因 此 读者 可 以 充分 利用 微 信 浏览 器 ， 开 发 适用 于 移动 端的 网 页 应 用 。 


最 明显 的 特征 是 ， 没 有 地 址 栏 ， 无 法 输入 URL。 那 么 怎样 浏览 网 页 呢 ? 至 少 有 以 下 三 种 方法 : 
` 点 击 对 话 中 的 URL 
` 公众 号 群发 图 文 消息 的 “阅读 原文 ”链接 


[1 扫 一 扫 ” 


这 里 推荐 第 3 种 方法 。 读 者 可 以 选择 一 个 二 维 码 生成 软件 ， 将 URL 生 成 为 二 维 码 ， 扫 描 二 维 码 即 可 打开 网 页 。 


微 信 浏 览 器 的 标识 (UA) 如 下 例 所 示 : 


Mozilla/5.0 (Linux; U; Android 4.1.1; zh-cn; MI 2 Build/JROO3L) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30 MicroMessenger/5.2.380 


可 以 看 出 ， 微 信 浏 览 器 的 名 称 为 MicroMessenger， 版 本 号 是 5.2.380。 开 发 应 用 时 ， 可 以 据 此 判断 是 否 是 在 微 信 中 打开 网 页 。 


人 


微 信 浏 览 器 还 支持 常见 的 HTML 5 特性 ， 如 video、audio、canvas、Local Storage 等 。 微 信 浏 览 器 在 HTML 5 规范 测试 网 站 (http://html5test.com/) 测试 的 结果 如 图 6-1 所 示 。 值 得 注意 的 是 ， 微 信 
浏览 器 不 支持 WebSocket、Full Screen、Web Notifications 等 存在 安全 隐患 或 影响 用 户 体 验 的 特性 。 





You are Using WeChat on a xlaoml rorerty wh XX 
MIl-2 running Android 4.1.1 


图 0-1 


这 里 简单 列 出 微 信 浏 览 器 所 支持 的 特性 。 需 要 说 明 的 是 ， 表 6-1 是 Android 4.1.1 系 统 下 微 信 5.2 版 本 的 测试 结果 汇总 。 不 同系 统 或 版 本 的 情况 ， 请 参考 html5test 网 站 的 结果 。 


时 性 EL 所 局 类 别 | 支持 与 员 
Knit ET 


支持 MPEG-4、H.264、WebM's VP8、WebM's 
Video 视频 相关 视频 是 ia 
VP9 等 格式 视频 文件 


Local Storage 本 地 存储 将 数据 保存 在 浏览 硕 里 ， 用 作 绥 存 


特 性 作 用 所 属 类 别 | 支持 与 否 i 








旧 
于 
河 


Geolocation 地 理 位 置 位 置 服 务 是 提供 地 理 位 置 服务 
SVG 可 缩放 矢量 图 形 解析 号 显示 矢量 图 形 
MathML 数学 标记 语言 铎 析 是 在 网 页 上 书写 数学 符号 和 公式 


WebSocket 用 于 客户 冰 与 服务 天 之 间 的 异步 通 
信 ， 本 身 无 害 。 但 微 信 是 通信 工具 ,注重 安全 和 


WebSocket 他 a i 
隐私 保护 ， 而 WebSocket 的 通信 功能 可 能 会 造成 
信息 泄露 

AMLHttpRequest 

通信 支持 文件 上 传 事件 
Level 2 






避免 影响 用 户 体验 


Web Notifications | 通知 本 | 避免 骚扰 用 户 


Webcam 合 有 安全 隐患 
3D graphics 3D 图 形 图 形 在 不 文 持 WebGL 及 WebGL 2 


6.1.2 WeixinJSBridge 


分 


Full Screen 


a 





微 信 的 JS 接口 封装 在 WeixinJSBridge， 这 里 介绍 一 下 WeixinJSBridge。 
使 用 WeixinJSBridge 有 两 个 前 提 : 

. 必须 在 微 信 浏 览 器 中 使 用 

. 必须 完成 初始 化 


第 一 个 前 提 是 因为 只 有 微 信 浏览 器 才 会 初始 化 WeixinJSBridge 这 个 对 象 。 在 其 他 手机 浏览 器 里 ，JS 是 不 能 调用 scanQRCode 接 口 来 打开 微 信 “ 扫 一 扫 ” 的 。 而 第 二 个 前 提 ， 与 常见 的 浏览 器 事件 一 
样 ，WeixinJsBridge 里 的 方法 不 会 在 事件 发 生前 被 执行 。 


微 信 浏览 器 在 何 时 初始 化 WeixinJSBridge 对 象 呢 ? 


为 了 回答 这 个 问题 ， 我 们 来 比较 以 下 三 个 事件 的 加 载 顺 序 ( 见 表 6-2) 。 


表 6-2 
ready DOM 加 载 完 毕 jQuery 特有 。 当 document 下 全 部 DOM 元 系 都 可 以 正确 加 载 
时 ， 就 会 触发 jQuery.ready0 事 件 
onload 网 页 加 载 完毕 标准 事件 。 当 页 面 所 有 元 素 及 资源 全 部 加 载 后 触发 此 事件 





onBridgeReady | 完成 WeixinJSBridge 初 始 化 微 信 浏览 需 特 有 。WeixinJSBridsge 初 始 化 完成 后 触发 此 事件 


在 一 个 页 面 中 ， 运 行 以 下 代码 (由 于 用 到 Query， 请 在 页 面 加 载 /Query 库 ) : 














document .addEventListener ('WeixinJSBridgeReady', function onBridgeReady() { 

if (typeof WeixinJSBridge == "object" && typeof WeixinJSBridge.invoke == "function") { 
alert(' WeixinJSBridge 

初始 化 完成 ')， 

} 

}); 

window.onload=function() { 

alert(" 

页 面 加 载 完成 ')，; 

}; 

$( document ) .ready (function() 1 

alert ('DOM 

加 载 完成 ) ; 

}) 



























































读者 可 以 扫 摘 下 面 的 二 维 码 看 下 效果 。 





| | 





你 会 发 现 ， 页 面 会 依次 弹出 “DOM 加 载 完 成 ”>、 “页 面 加 载 完成 ”x。 页 面 内 容 完 成 呈现 ， 表 等 1 至 2 秒 后 才 出 现 “WeixinJSBridge 初 始 化 完成 ”， 如 图 6-2 所 示 。 





WeixInJSBridge 初 始 化 元 成 





由 此 ， 可 以 看 出 事件 的 触发 顺序 为 : ready 一 onload 一 onBridgeReady。 


那么 ， 我 们 得 出 结论 ，WeixinJsBridge 的 初始 化 是 在 页 面 加载 完 毕 之 后 开始 的 。 也 就 是 说 ， 只 有 在 页 面 加载 完 成 后 ， 才 能 使 用 微 信 JS 接 口 。 








wy 


天 WA/ ，、 CD | a /一 CD: 口 口 
6.2 WelxinJsBridge 使 用 上 品 明 


在 微 信 公 众 平台 开发 者 问答 系统 中 ， 经 常 有 了 网友 询 问 WeixinJSBridge 相 关 的 问题 ， 可 见 网 友 还 是 很 期 待 微 信 JS 接 口 的 。 目 前 官方 给 出 了 三 个 接口 的 使 用 说 明 : 隐藏 微 信 中 网 页 右上 角 按 钮 、 隐 藏 微 信 中 
网 页 底部 导航 栏 和 网 页 获取 用 户 网 络 状态 。 然 而 网 友 发 现 微 信 的 JS 接 口 不 止 以 上 三 个 ， 比 如 分 享 到 微 信 朋 友 圈 、 发 送 给 微 信 好 友 等 接口 都 是 可 用 的 ， 并 形成 了 开源 项 目 。 


目前 微 信和 官方 尚未 给 出 WeixinJsBridge 的 使 用 说 明 ， 这 给 希望 使 用 微 信 Js 开发 的 开发 者 带 来 了 一 定 的 困难 。 笔 者 根据 网 络 资源 和 本 人 的 开发 经 验 ， 整 理 出 WeixinJsBridge 的 使 用 说 明 ， 和 希望 对 读者 有 所 
帮助 。 
声明 : 该 部 分 的 使 用 说 明 不 代表 任何 单位 的 官方 文档 ， 仅 是 个 人 解读 。 同 时 微 信 官方 有 可 能 对 接口 进行 修改 和 调整 ， 如 果 读 者 发 现 接口 使 用 不 了 ， 请 访问 微 信 公 众 平 台 官 网 获取 最 新 信息 。 


6.2.1 WeixinJSBridge 接 口 一 抠 


WeixinJSBridge 包 含 了 众多 接口 ， 按 其 功能 可 划分 为 以 下 几 类 : 

" 界面 : 主要 用 于 隐藏 或 显示 WebView 的 一 些 组 件 和 按钮 ， 包 含 隐藏 /显示 WebView 右 上 角 的 分 享 按钮 ， 关 闭 WebView 等 。 

. 分 享 : 分 享 到 腾讯 微 博 、 朋 友 圈 ， 发 送 邮 件 等 。 

功能 : 图 片 预 览 ， 获 取 当 前 网 络 类 型 等 。 

“ 公众 号 : 关注 公众 号 等 。 

- 事件 监听 : 监听 分 享 按钮 的 “发 送 给 朋友 ”按钮 的 点 击 事件 ， 监 听 分 享 按钮 的 “分 享 到 朋友 图” 按钮 的 点 击 事件 ， 监 听 分 享 按钮 的 “分 享 到 腾讯 微 博 ” 按 钮 的 点 击 事件 。 
. 第 三 方 App: 包括 获取 第 三 方 App 安 装 情 况 ， 添 加 下 载 任务 ， 查 询 下载 任 务 ， 取 消 下 载 任务 等 。 


上 述 接口 中 有 些 信息 敏感 或 涉及 隐私 的 接口 还 是 需要 申请 权限 后 才能 使 用 ， 这 类 接口 包括 联系 人 、 表 情 、 公 众 号 支付 等 。 同 时 不 能 排除 微 信 更 新 版 本 时 接口 调用 权限 发 生变 化 的 可 能 ， 因 此 ， 读 者 在 开 
发 应 用 中 想 知 道 是 否 有 权限 时 ， 最 好 实际 调用 一 下 。 


图 6-3 为 微 信 5.2.1 版 本 WeixinJSBridge 接 口 的 知识 图 谱 ， 带 “*” 的 接口 表示 需要 申请 权限 才能 使 用 。 


隐 荐 /显示 WebView 右 上 角 的 分 享 按钮 






发 送 给 朋友 "按钮 的 点 击 事件 隐藏 /显示 WebView 底 部 的 导航 栏 
.分 享 到 朋友 轿 " 技 钮 的 点 击 事件 ]=| 事件 监听 < 
分享 到 腾讯 微 博 "按钮 的 点 击 事件 关闭 WebView 
* 阮 转 到 指定 界面 
图 片 预览 
获取 当前 网 络 类 型 | 功能 * 分 享 到 腾讯 微 博 





* 分 享 到 朋友 图 







日 
性 





全 | AN 
关注 局 公众 号 * 发 送 自 定义 信息 给 朋友 


* 自 定义 分 享 到 朋友 图 的 内 容 






获取 安装 状态 







打开 第 三 方 APP 发 起 支付 请 求 
添加 下 载 任务 ( Android ) 站 | * 第 三 方 APP * 微 信 支 付 鲜 编辑 收 货 地 址 
取消 下 载 任务 ( Android ) 获取 最 近 的 收 货 地 址 






查询 下 载 状态 ( Android ) 





6.2.2 ”界面 接口 


1. 隐 藏 /显示 WebView 右 上 角 的 分 享 按钮 


在 微 信 浏 览 器 中 打开 网 页 ， 右 上 角 会 默认 出 现 分 享 按钮 ， 用 于 将 网 页 发 送 给 朋友 、 分 享 到 朋友 圈 、 分 享 到 腾讯 微 博 等 ， 如 图 6-4 所 示 。 


《舌尖 2》 第 二 
峡 ， 图 sir 市 你 





2014-04-27 ”腾讯 地 图 
《 百 完 28 第 二 集 【 
区 1 上 人 
马 去 到 那个 地 方 品 宇 
罗列 出 来 了 ， 并 且 导 
际 亚 昵 。 五 一 假期 去 
以 去 饱 乌 口福 哦 ~ 


E Er 

















在 浏览 器 


快 盘 


但 是 有 时 可 能 不 需要 分 享 按钮 ， 比 如 中 奖 消息 、 提 醒 信息 等 信息 敏感 的 网 页 ， 公 众 号 运营 者 不 希望 这 些 网 页 被 分 享 到 社交 网 站 上 。 微 信和 官方 的 开发 接口 同时 提供 了 隐藏 和 显示 分 享 按钮 的 解决 方法 ， 具 


体 代码 如 下 : 


WeixinJSBridge.invoke ("hideOptionMenu");// 
隐藏 分 享 按钮 
WeixinJSBridge.invoke ("showOptionMenu");// 
显示 分 享 按钮 ， 目 前 只 文 持 Android 














在 微 信 浏 览 器 中 打开 网 页 后 ， 底 部 会 出 现 一 个 导航 栏 ， 用 于 浏览 器 前 进 、 后 退 和 刷新 功能 ， 如 图 6-5 所 示 。 





图 06-5 


如 果 公众 号 运 曹 者 认为 用 户 在 该 页 面 不 会 用 到 导航 栏 ， 或 者 希望 隐藏 导航 栏 来 实现 瀑布 流 ， 可 以 隐藏 掉 底 部 的 导航 栏 。 微 信 官 方 提供 的 方法 如 下 : 








WeixinJSBridge.invoke ("hideToolbar");// 
隐藏 底部 导航 栏 
WeixinJSBridge.invoke ("showToolbar");// 
显示 底部 导航 栏 














另外 微 信 官方 还 提供 了 一 个 Hack 方 法 。 如 果 希 望 页 面 打 开 时 就 不 出 现 导 航 栏 ， 可 以 在 页 面 URL 的 尾部 加 上 销 部 分 #wechat_webview_type=1。 例 如 访问 http://devweixin.sinaapp.com/demo/tool- 
bar.html#wechat_webview_type=1， 页 面 的 导航 栏 自动 隐藏 。 笔 者 对 这 个 方法 做 了 简单 测试 ， 结 果 如 表 6-3 所 示 : 


表 6-3 


增加 Hash 显示 效果 


#wechat webview type=0 显示 分 享 按 钮 和 导航 栏 
#wechat webview type=1 显示 分 享 按钮 ， 隐 藏 导 航 栏 
#wechat webview type=2，3，4，S，……… 隐藏 分 享 按钮 ， 显 示 导 航 栏 


3. 跳 转 到 扫描 二 维 码 界面 
是 否 可 以 调用 微 信 有 的 “ 扫 一 扫 ” 功 能 呢 ? 答案 是 可 以 。 如 果 读 者 在 开发 中 ， 需 要 用 户 去 扫 某 个 二 维 码 、 条 形 码 ， 可 以 调用 下 面 的 接口 。 


WeixinJSBridge.invoke ("scanQRCode");// 

\ 带 回调 函数 
WeixinJSBridge.invoke ("scanQRCode", {},function (res){// 
带 回调 函数 


alert (res.err msg); 





























需要 读者 注意 的 是 ， 尽 管 第 二 种 形式 提供 了 回调 函数 ， 但 在 实际 操作 中 无 法 从 “ 扫 一 扫 ” 界 面 返 回 原来 的 网 页 ， 使 得 回调 函数 的 作用 大 打折 扣 ， 而 且 用 户 跳 走 了 回 不 来 ， 所 以 此 功能 要 慎 用 。 
4. 关 闭 WebView 


在 普通 浏览 器 中 可 以 关闭 网 页 ， 在 微 信 浏 览 器 中 也 可 以 。 如 果 需 要 关闭 网 页 ， 可 以 调用 如 下 命令 : 








WeixinJSBridge.invoke ("closeWindow") 








5. 跳 转 到 指定 界面 


微 信 提供 了 常见 页 面 的 跳 转 接 口 ， 调 用 代码 如 下 : 








WeixinJSBridge.invoke ("openSpecificView", i 

"specificview": "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/..." 
}, function (res)t{ 

alert (res.err msg); 


























其 中 specificview 参 数 的 值 如 表 6-4 所 示 。 


specificview 参 数 跳 转 页 面 


timeline 朋友 圈 
scan 扫 一 扫 
discover 发 现 
myprofile 个 人 信息 
myaccount 我 的 账号 
general 通用 


privacy 隐私 


6.2.3 “分 享 接口 















































WeixinJSBridge 支 持 分 享 到 腾讯 微 博 、 分 享 到 朋友 圈 、 发 邮件 ， 以 及 发 送 自 定义 信息 给 朋友 。 
1. 分 享 到 腾讯 微 博 
WeixinJSBridge.invoke ("shareWeibo", 
url: "http://http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/...", 
content: "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/...", 
type: "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/..." 
}, function (res) { 











alert (res.err msg); 


和 














参数 说 明 见 表 6-5: 


党 * 
url 
content 
type 

err_msg 返 回 值 见 表 6-6: 

res.err_msg 返 回 值 
share Welbo:cancel 
share Welbo:no_ Welbo 
share welbo:not bind qq 


share welbo:fall < 失败 锁 


2. 分 享 到 朋友 圈 


表 6-5 
说 明 
分 侍 链 接地 址 
分 至 到 腾讯 微 博 的 内 容 
music,vido 或 lnk， 默 认为 lnk 
表 6-6 


说 

用 户 取 消 
用 户 未 开 

用 户 未 绑 定 QQ 


明 


用 微 所 博 


» Vv 


发 送 失 败 + 失 败 错误 码 





WeixinJSBridge.invoke ("shareTimeline", 















































img url:"http://http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/..." 
img width: "120", 
img height: "120", 
link: "http://http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/...", 
desc: " 

描述 "， 
title: " 

标题 " 

}, function (res) { 


alert (res.err msg); 





参数 : 参考 “发 送 消息 给 朋友 ”API 


err_msg 返 回 值 ( 见 表 6-7) : 


err_msg 返 回 值 


share timeline:cancel 


3. 友 邮件 


说 明 
用 户 取 消 








WeixinJSBridge.invoke ("sendEmail", 
title: 
content: 

}, function (res) { 
alert (res.err msg); 


中 





























"http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/..." 
"http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/..." 























参数 说 明 见 表 6-8 


0-8 


title 


\ 


content 


err_msg 返 回 值 见 表 6-9: 





























说 明 
邮件 标题 
邮件 内 容 




















表 6-9 
err_msg 返 回 值 说 明 
send email:title link empty 标题 或 内 容 为 空 
send email:title too long 标题 过 长 
a 一 MN 1 WY Ve 
send emall:cancelled 取消 发 送 
send email:saved 邮件 被 保存 
4. 友 和 送 自 定义 信息 给 朋友 
WeixingSbridge, invoke ("sendAppMessage", { 
d: 
i "http: //http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/...", 
img width;: "120" 
img - height: 207 
link: "http://http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/...", 
deset; ™ 
描述 m 
title: " 
标题 " 
}, function (res) { 
alert (res.err msg); 
}); 
参数 说 明 见 表 6-10: 
表 6-10 


参数 


W 


appld 非 必 填 ， 公 众 号 AppID 
IDg_UI] 非 必 填 ， 图 文 消息 图 片 的 地 址 


非 必 填 ， 图片 的 宽度 和 划 ， 微 信 客 
填 入 图 片 真实 宽度 


非 必 填 ， 同 上 ， 


IDg width 


文 是 图 片 高 度 


IDg height 


type 非 必 十，muslc、 
data url 非 必 十 ， 数 据 链接 地 址 ， 
link 图 文 消息 的 链接 
desc 图 文 消 息 的 描述 
title 图 文 消息 的 标题 
err_msg 返 回 值 见 表 6-11: 
err_msg 返 回 值 


send app msg:cancel 


6.2.4 监听 事件 


为 了 在 分 享 时 实现 自 定义 内 容 、 


读者 在 开发 过 程 中 ， 可 能 需要 自 定义 分 享 到 朋友 圈 的 内 容 ， 


户 冰 将 此 人 参数 


如 音乐 的 mp3 数 


志 记 录 和 数据 上 报 ，WeixinJSBridge 有 监听 “发 送 给 朋友 " 


包括 图 片 、 描 述 、 内 容 等 。 


说 有明 


告诉 接收 方 ， 用 于 一 些 展示 相关 的 操作 ， 所 以 建议 


Video 或 lnk， 不 二 默认 为 lnk 


效 据 地 址 ， 供 内 置 播放 硕 使 用 


表 6-11 
说 明 
用 户 取消 


“分 享 到 朋友 圈 ”、 “分 享 到 腾讯 微 博 ”按钮 点 击 事件 的 监听 接口 。 


这 里 提供 一 个 Hack 方 法 ， 在 网 页 JS 脚本 中 定义 一 个 $shareConfig 的 对 象 ， 然 后 监听 分 享 按钮 的 点 击 动作 ， 捕 获 


到 事件 后 将 微 信和 默认 的 标题 、 图 片 换 成 自 定义 即 可 。 例 如 腾讯 微 博 与 微 信 公众 平台 的 合作 页 面 中 就 用 到 了 这 种 方法 。 例 如 微 视 的 客人 页 (http://w.t.qq.com/wuxian/home/guest?id=weishi) 


的 代码 如 下 : 


Els 





Var S$ShareConfig={ 
"img": "http://t2.gqlogo.cn/mbloghead/cd9ddb0f2e9822f3fqdpbc/120", 





























"desc" : 1 

微 视 是 一 个 短视 频 分 享 社 区 ， 用 八 秒 讲述 你 我 的 故事 。"， 
"COntent": ™ 

推荐 微 视 的 微 博 "， 
由 北 于 蕊 二 全 于 





推荐 微 视 的 微 博 ", 
cmpTitle": "# 
自 微 博 阅 读 插 件 # 
推荐 Qweishi 














事件 监听 部 分 的 代码 如 下 : 


AN 
思 圣 


到 朋友 











EE 


(window.$ShareConfig) { 
Var url = document.1location.href; 
WeixinJSBridge.on ("menu:share:timeline",// 
监听 分 享 到 朋友 圈 事 件 
function() { 
window.$ShareConfig && WeixinJSBridge.invoke ("shareTimeline", { 
img url: $ShareConfig.img, 
img width: "65", 
img height: "65"™, 
link: url, 
desc: S$ShareConfig.desc, 
title: $ShareConfig.content 





























}, 
function(e) { 
WeixinJSBridge.1log(e.err msg) 

















}) 
}); 
WeixinJSBridge.on ("menu:share:weibo",// 
监听 分 享 到 腾讯 微 博 事件 
function() { 
window.s$ShareConfig && WeixinJSBridge.invoke ("shareWeibo", 
img url: $ShareConfig.img, 
jm widths “657 
img height: "65", 
link: url, 
trls. WEL; 
desc: S$ShareConfig.desc, 
content: $ShareConfig.cmpTitle 


























}, 
function(e) { 
WeixinJSBridge.1log(e.err msg) 











}) 
}); 
WeixinJSBridge.on ("menu:share:appmessage",// 
监听 发 送 给 朋友 事件 
funotiornt(t) { 
window.S$ShareConfig && WeixinJSBridge.invoke ("sendAppMessage", { 
appid: wr 
img url: $ShareConfig.img, 
img width: "65", 
img height: "65"™, 
link: url, 
desc: S$ShareConfig.desc, 
title: $ShareConfig.title 
































}, 
function(e) { 
WeixinJSBridge.1log(e.err msg) 

















}) 





选择 菜单 中 的 “分 享 到 朋友 圈 ”， 读 者 将 会 发 现 分 享 的 图 片 和 标题 都 是 自 定 义 的 内 容 ( 见 图 6-6) 。 





0-0 


读者 可 以 用 微 信 扫描 下 面 的 二 维 码 查看 微 视 客人 页 的 效果 。 


i 











微 信 开放 了 一 些 功能 接口 ， 包 括 图 片 预览 和 获取 网 络 状态 。 


(1) 图 片 预览 





WeixinJSBridge.invoke ("imagePreview", { 
"Tourrent ss ™ 
当前 图 片 url1"， 
rls™ el "ell "12"| 
}, function (res)t{ 
WeixinJSBridge.1log (res.err msg); 

















I 


(2) 获取 当前 网 络 状态 





WeixinJSBridge.invoke ("getNetworkType", {}, 
WeixinJSBridge.1log (res.err msg); 
}); 








function (res) { 








err_msg 返 回 值 见 表 6-12: 


表 6-12 


err_msg 返 回 值 说 明 


network type:fall 网 络 断 开 连 接 
network type:edge 非 W， 包 含 3G/2G 
network type:wwan 2G 或 4G 

network type:wifi Wif 网 络 


6.2.6 第 三 方 APP 接 口 


想必 读者 都 听 说 或 参与 过 2014 年 4 月 至 5 月 的 微 信 扫 红 码 活动 吧 ? 使 用 微 信 扫 描 红 码 后 将 通过 应 用 宝 下 载 安 装 。 每 成 功 安装 1 个 红 码 应 用 ， 即 可 获得 1 个 微 信 红 包 ， 红 包 人 金额 随机 发 放 。 这 个 活动 迅速 火爆 
起 来 ， 丝 毫 不 亚 于 “ 微 信 新 年 红包 ”，“ 红 码 风暴 ” 吹 遍 了 整个 移动 互联 网 行业 ， 也 使 应 用 宝 迅速 崛起 。 


而 微 信 扫 红 码 下 载 APP， 背 后 的 技术 正 是 第 三 方 APP 接 口 。 


1. 获 取 安 装 状 态 








WeixinJSBridge.invoke ("getInstal1LState"y { 
"packageName": "Android 
包 名 "， 
"packageUrl": "IOS URL Scheme " 
}, function (zes){ 
WeixinJSBridge.1log (res.err msg); 


这 





























参数 说 明 见 表 6-13: 


表 6-13 


参 数 说 。 有 表 


packageName 应 用 程序 的 包 名 ， 用 于 Android 平 台 ， 如 : com.tencent.WBloeg 
packageUrl URL Scheme， 用 于 IOS 平 台 ， 如 TencentWeibo:// 


err_msg 返 回 值 见 表 6-14: 


表 6-14 


err msg 返回 值 说 明 


missing areuments 缺少 输入 参数 
get install state:yes [version] 已 安 灾 ， 其 中 Android 会 返回 版 本 号 version，IOS 则 不 返回 版 
get lnstall state:no 未 安 妆 

2. 打 开 第 三 方 APP 








1 






































"appID" : "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompresseq/14881/OEBPSVText/..."， 
"messageExt" : "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/...", 
"extInfo" : "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/..." 


























},function (res) { 
alert (res.err msg); 


] 
参数 说 明 见 表 6-15: 


表 6-15 


参 数 说 。 有 表 


appID 第 三 方 应 用 在 微 信 公众 平台 申请 的 appID 
messageExt(IOS) 韭 必 填 ， 第 三 方 应 用 目 定 义 简单 数据 ， 微 信和 终端 会 回 传 给 第 三 方程 序 处 
extInfo(Android) 理 ， 如 : "fom=webview" 


3. 打 开 第 三 方 APP 〈 仅 支持 Android)) 











WeixinJSBridge.invoke ("launch3rgdApp", { 
"packageName": "nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/...", 
"siqnature": "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/...", 
































"type": 1 
}, function(res) { 
alert (res.err msg); 


}); 





参数 说 明 见 表 6-16: 


表 6-16 


参 数 说 明 


packageName 应 用 程序 的 包 名 ， 用 于 Android 平 台 ， 如 : com.tencent.WBlog 
signature apk 的 签名 


4. 添 加 APP 下 载 任务 ( 仪 支持 Android) : 


WeixinJSBridge.invoke ("addDownloadTask", { 
"task mame": ™",) 
"task url": "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 


"file md5": "http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/..." 
}, function (zes){ 


alert (res.download id + ", " + res.err msg); 












































县 

















灯光 


添加 成 功 后 ， 微 信 会 给 当前 任务 分 配 download id， 用 于 唯一 标识 该 任务 ， 后 续 可 以 执行 查询 下 载 进 度 、 取 消 下 载 任务 等 操作 。 最 好 用 cookie 或 Local storage 人 存储 起 来 ， 这 样 即 使 网 页 刷新 ， 该 任务 id 
仍然 能 获得 。 


参数 说 明 见 表 6-17: 
表 6-17 
参数 说 朋 
task name 下 载 任务 的 名 称 ， 如 “ 微 信 5.3” 
ns i 下 载 APP 的 URL 


file md5 下 载 APP 的 MD5 


5. 取 消 APP 下 载 任务 ( 仪 支持 Android) : 








WeixinJSBridge.invoke ("cancelDownloadTask",{ 


"download id": "nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/..." 
},function (res)t{ 
alert (res.err msg); 


}); 


























参数 说 明 见 表 6-18: 
表 6-18 
参 数 说 明 


download id addDownloadTask 调 用 时 微 信 分 配 的 ID 


6. 查 询 APP 下 载 状态 ( 仅 支 持 Android) : 


WeixinJSBridge.invoke ("queryDownloadTask", 
"download id": "nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/..." 
}, function (res) { 

alert (res.state + "," + res.err msg); 


} 


























res.state 返 回 值 见 表 6-19: 


表 6-19 

res.state 说 明 
download succ 下 载 成 功 
downloading 下 载 中 


default 未 下 载 
download fail 下 载 失 败 


7. 安 装 下 载 成 功 的 APP ( 仅 支 持 Android) : 





WeixinJSBridge.invoke ("installDownloadTask", { 

"download id": "nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/..." 
;function (res) { 

alert (res.err msg); 


























CE 


坷 学 





8. 监 听 APP 的 下 载 状态 ( 仅 支 持 Android) : 








WeixinJSBridge.on ("wxdownload:state change", function (res) { 
alert (res.download id + res.state); 








res.download id 
: agddDownloadTask 
调用 时 客户 端 分 配 的 ID 

















res.state 返 回 值 见 表 6-20: 


表 6-20 

res.state 说 有明 

download succ 下 载 成 功 
downloading 下 载 中 
default 末 下 各 

download fail 下 载 失 败 


6.3 案例 


为 帮助 读者 更 好 地 利用 WeixinJSBridge 来 进行 开发 ， 这 里 提供 一 些 接口 示例 。 


6.3.1 ”WeixinJSBridge 的 加 载 顺 序 


在 微 信 公 众 平台 开发 者 问答 系统 中 看 到 如 图 6-7 所 示 的 问题 


WeixinJsBridge 的 hidetoolbar 是 个 异步 方法 ? 


浏览 ; 112 时间: 4 月 17 日 ”作者 : 国 国 (120 积分 ) 分 类 :Wechat JS 
WeixirJSsBndoge 


在 Andriod 上 最 Mi 认 旺 有 底部 的 toolbar 的 。。。 但 旺 我 不 怖 要 这 个 bar ,可 旺 这 个 bar 的 存在 影响 了 我 对 dom 的 计算 
。 因为 我 雪人 做 天 全 屏 滚 动 的 。。。 所 以 坝 在 hidetoolbar 后 ， 才 调用 一 些 初始 化 方法 . 。。 经 过 测试 。。。 点 


WeixinJ$Bridge.call(hideToolbar):alert(1): 居 然 先 alert ,然后 才 消 先 toolbar ,， 求 大 神 指 教 ， 怎 么 等 toolbar 人 隐藏 
后 ， 才 放 始 乒 的 急 始 化 啊 。。 固 为 此 图 和 5 有 有 回 山 。。 僵 虱 





为 什么 位 于 后 面 的 alert (1) 要 先 于 hidetoolbar 执 行 呢 ? 


在 6.1.2 节 中 ， 我 们 讨论 了 WeixinJSBridge 的 加 载 顺 序 ， 并 指明 : 只 有 在 页 面 加 载 完 成 后 ， 才 能 使 用 微 信 Js 接口 。 上 述 问题 的 根源 在 于 ， 没 有 弄 清楚 WeixinJSBridge 人 在 什么 时 候 完 成 初始 化 。alert (1) 


在 window load 的 时 候 就 加 载 ， 而 WeixinJSBridge.call (hideToolbar ) 要 在 WeixinJSBridge ready 之 后 才 执行 。 图 6-8 形 象 地 说 明了 加 载 顺 序 和 代码 执行 的 对 应 关系 。 


window load 


WeixinJsBridge WelxinJSBridge.call 
ready (hideIoolbar ); 


加 载 顺 序 代码 执行 





图 0-8 


这 样 ， 读 者 应 该 理解 为 什么 alert (1) 要 先 执行 了 吗 ? 只 与 WeixinJSBridge 的 触 友 时 机 相关 ， 与 同步 异步 无 关 。 


6.3.2 ”隐藏 /显示 WebView 右 上 角 的 分 享 按 钮 


代码 示例 : 


<!DOCTYPE HTML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 

<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 

<script type="text/javascript"> 







































































// 

全 局 变量 ， 用 于 标识 WeixinJSBridge 
是 否 完 成 初始 化 ，0 

为 未 完成 ，1 

为 已 完成 

winxinJsBridgeReady = 0; 

// 


处 理 WeixinJSBridgeReady 























事件 ， 当 初始 化 完成 后 ， 将 winxinJsBridgeReady 
标记 为 1 
document .addEventListener ('WeixinJSBridgeReady', function onBridgeReady() { 









































if (typeof WeixinJSBridge == "object" && typeof WeixinJSBridge.invoke == "function") { 
winxinJsBridgeReady = 1; 


} 











有 


4 
function Show() { 





// 

判断 WeixinJSBridge 

是 否 完 成 初始 化 ， 完成 即 可 执行 命令 ， 否则 弹出 提示 

if (winxinJsBridgeReady === 1){ 
WeixinJSBridge.call ('showOptionMenu'); // 






































. document .getElementById('tips') .innerHIML=" 
分 享 按钮 己 显 示 ! > 























}elsef{ 
alert ('WeixinJSBridge 

未 初始 化 成 功 ') 

} 
} 
/** 
大 
隐藏 分 享 按钮 
*y 


function hide()t{ 





判断 WeixinJSBridge 

是 否 完成 初始 化 ， 完成 即 可 执行 命令 ， 否则 弹出 提示 

if (winxinJsBridgeReady === 1){ 
WeixinJSBridge.call ('hideOptionMenu'); // 
























































隐藏 分 享 按钮 
document .getElementBylId('tips') .innerHIML=" 
分 享 按钮 已 隐藏 !"; 
}elsel 





alert ('WeixinJSBridge 





未 初始 化 成 功 ') 


上 
} 
</script> 
<title> 
隐藏 / 
显示 分 享 按钮 演示 </title> 
</head> 
<body> 


<p> 

点 击 下 列 的 按钮 隐藏 / 

显示 WebView 

右上 和 角 的 分 享 按钮 </p> 

<ul > 

<] 1L><input type=button value=" 
隐藏 "” onclick="hige();"></1i> 
<1i><input type=button value=" 
显示 " onclick="show();"></1i> 
</ul> 

<span igd="tips"></span> 
</body> 

</html> 





























显示 结果 如 图 6-9 和 图 6-10 所 示 : 


点 击 下 列 的 按钮 隐藏 /显示 WebView 右 上 角 的 分 
享 按 包 


分 享 按 钮 已 隐藏 





氮 击 下 列 的 按 适 隐藏 /显示 WebVIew 石 上 角 的 分 
旱 控 型 


分 圣 按 钮 已 显示 | 





读者 可 以 用 微 信 扫描 下 面 的 二 维 码 查看 显示 或 隐藏 分 享 按钮 的 效果 : 





6.3.3 ”隐藏 /显示 WebView 底 部 的 导航 栏 


代码 示例 : 


<!DOCTYPE HTML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 

<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 

<script type="text/javascript"> 

// 
全 局 变量 ， 用 于 标识 WeixinJSBridge 
是 否 完成 初始 化 ，0 







































































为 未 完成 ，1 

为 已 完成 
winxinJsBridgeReady = 0; 
// 


处 理 WeixinJSBridgeReady 






















































































事件 ， 当 初始 化 完成 后 ， 将 winxinJsBridgeReady 
标记 为 1 
document .addEventListener ('WeixinJSBridgeReady', function onBridgeReady() { 
if (typeof WeixinJSBridge == "object" && typeof WeixinJSBridge.invoke == "function™") { 
winxinJsBridgeReady = 1; 
} 
}); 
/** 
大 
显示 导航 栏 
*7 
function Show() { 
// 
判断 WeixinJSBridge 
是 否 完成 初始 化 ， 完 成 即 可 执行 命令 ， 否 则 弹出 提示 
if (winxinJsBridgeReady === 1){ 














WeixinJSBridge.call ('showToolbar');// 


显示 导航 栏 




















document .getElementBylId('tips') .innerHIML=" 
导航 栏 已 显示 !"; 
}elselt 
alert ('WeixinJSBridge 
未 初始 化 成 功 '); 
} 


} 









































/** 
大 
隐藏 导航 栏 
*/ 
function hide(){ 
判断 WeixinJSBridge 
是 否 完成 初始 化 ， 完 成 即 可 执行 命令 ， 否 则 弹出 提示 
if (winxinJsBridgeReady === 1){ 
加 WeixinJSBridge.call ('hideToolbar');// 
隐藏 导航 栏 
document .getElementBylId('tips') .innerHIML=" 
导航 栏 已 隐藏 !"; 
}elsel 





二 有 alert ('WeixinJSBridge 
初始 化 成 功 '); 
} 


} 

</script> 

<title> 

隐藏 / 

显示 导航 栏 演示 </title> 
</head> 

<body> 


<p> 

点 击 下 列 的 按钮 隐藏 / 

显示 WebView 

底部 的 导航 栏 </p> 

<ul > 

<1i><input type=button value=" 
隐藏 "onclick="hiqde ();"></1i> 
<1i><input type=button Value=" 
显示 " onclick="show();"></1i> 
</ul> 

<span igd="tips"></span> 
</body> 

</html> 
































显示 结果 如 图 6-11 和 图 6-12 所 示 : 


坦 泌 /显示 导航 | 


导航 栏 已 显示 





图 0-11 


( 人 约 隐藏 /显示 导航 栏 演示 


凡 击 下 列 的 按钮 隐 着 /显示 WebVlew 瓜 部 的 寻 航 
己 





读者 可 以 用 微 信 扫 摘 下 面 的 二 维 码 查 看 显示 或 隐藏 导航 栏 的 效果 : 


代码 示例 : 











t-Type" content="text/h 
























































tml; 





charset=utf-8" /> 

















<!DOCTYPE HTML> 

<html> 

<head> 

<meta http-equiv="Conten 

<meta name="viewport" conten 

<meta name="format-detec 

<meta name="apple-mobile-web-app-capable" content="yes" /> 
<script type="text/javascript"> 

// 

全 局 变量 ， 用 于 标识 WeixinJSBridge 

是 否 完成 初始 化 ，0 

为 未 完成 ，1 

为 已 完 

winxinJsBridgeReady = 0; 

// 

处 理 WeixinJSBridgeReady 

事件 ， 当 初始 化 完成 后 ， 将 winxinJsBridgeReady 
标记 为 1 


document .adqdj 


Eventl 


'istener(' 





leixinJSBridgeReady', 























liI 


} 
}); 


/** 
大 


跳 转 到 扫 











( 


描 二 维 码 界 节 





typeo 





function onl 


BridgeReady() { 











F WeixinJSBridge == "object" && 





winxinyJsi 


























Ww 





判断 WeixinJ 
是 否 完成 初始 











Fis 





化 ， 未 完成 下 


function scan () { 


//// 
JS] 





Bridge 








口 








接 返 回 fa 














BridgeReady = 1; 


lse 











f (winxinyJs] 








BridgeReady 
alert ('WeixinJS] 


) { 
Bridge 








typeo 








F WeixinJSBridge.invoke == "| 





Function") 





t="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
tion" content="telephone=no™" /> 


{ 


未 初始 化 成 功 '); 


return false; 
} 


if (confirm(" 


是 否 到 扫 一 扫 界面 ? ") ) { 
alert(" 
即将 进入 扫 一 扫 界 面 '); 


WeixinJSBridge.invoke ("scanQRCode");// 
跳 转 到 扫描 二 维 码 界面 


}elsel{ 
alert('" 
你 选择 不 进入 扫 一 扫 界 面 ')，; 
} 


} 

</script> 

<title> 

跳 转 到 扫描 二 维 码 界面 演示 </title> 
</head> 

<body> 


<p> 

点 击 下 面 的 按钮 跳 转 到 扫描 二 维 码 界面 </p> 
<input type=button value=" 

扫 一 扫 " onclick="scan ();"> 

</body> 

</html> 


















































显示 结果 如 图 6-13 所 示 : 


slInaapp.com 的 岗 册 亚 示 : 


即将 进入 扫 一 扫 界 面 


确 正 





图 0-13 


读者 可 以 用 微 信 扫描 下 面 的 二 维 码 查看 跳 转 到 扫 摘 二 维 码 界面 的 效果 : 











代码 示例 : 






































F-8" /> 





Charset=ut 1: 








<!DOCTYPE HTML> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; 

<meta name="viewport" conten 

<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 
t/javascript"> 


<script type="text 
// 











全 局 变量 ， 
是 否 完成 初始 
为 未 完成 ，1 
为 已 完成 








化 ，0 


winxinJsBridgeReady = 0; 


处 理 WeixinJSBridgeReady 
化 完成 后 ， 将 winxinJsBridgeReady 











事件 ， 当 初始 








用 于 标识 WeixinJSBridge 


























function onl 





BridgeReady() { 










































































标记 为 1 

document .addEventListener ('WeixinJSBridgeReady', 
if (typeof WeixinJSBridge == "object" && typeo 

winxinJsBridgeReady = 1; 

} 

}); 

/** 

大 

关闭 WebView 

*/ 

function closeWindow(){ 

判断 WeixinJSBridge 

是 否 完成 初始 化 ， 未 完成 直接 返回 false 
if (winxinJsBridgeReady === 0){ 











F WeixinJSBridge.invoke == "| 





Function") 


t="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 


{ 


未 初始 { alert ('WeixinJSBridge 
初始 化 成 功 '); 


return false; 
} 


if (confirm(" 
是 否 关闭 网 页 ? ") ) { 
alert('" 





Eg 











WeixinJSBridge.invoke ("closeWindow");// 
关闭 WebView 
}elselt 
alert('" 


你 选择 不 关闭 网 页 ') ; 
} 


} 

</script> 
<title> 

关闭 WebView 
演示 </title> 
</head> 
<body> 


<p> 

点 击 下 面 的 按钮 关闭 WebView</p> 
<input type=button value=" 
关闭 " onclick="closeWindow ();"> 
</body> 

</html> 








效果 如 图 6-14 所 示 ， 点 击 确定 后 ， 当 前 网 页 就 会 关闭 。 





图 0-14 


读者 可 以 用 微 信 扫 摘 下 面 的 二 维 码 查看 关闭 WebView 的 效果 : 





代码 示例 : 


<!DOCTYPE HTML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 

<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 

<script type="text/javascript"> 

// 
全 局 变量 ， 用 于 标识 WeixinJSBridge 
是 否 完成 初始 化 ，0 







































































为 未 完成 ，1 

为 已 完成 
winxinJsBridgeReady = 0; 
// 


处 理 WeixinJSBridgeReady 
































事件 ， 当 初始 化 完成 后 ， 将 winxinJsBridgeReady 
标记 为 1 
document .addEventListener ('WeixinJSBridgeReady', function onBridgeReady() { 





























if (typeof WeixinJSBridge == "object" && typeof WeixinJSBridge.invoke == "function™") 1{ 
winxinJsBridgeReady = 1; 


} 














2 


/** 
发 邮件 
4 


function sengdMail (){ 


//// 








ee 
否 完成 初始 化 ， 未 完成 直接 返回 false 
if (winxinJsBridgeReady === 0) { 
alert ('WeixinJSBridge 
未 初始 化 成 功 ') 


return false; 





























var title = " 
邮件 标题 ' ; 
Var content = " 
通过 微 信 发 邮件 ， 真 是 高 上 大 ! '; 
WeixinJSBridge.invoke ("sendEmail", 
title: title, 
content: content 
}, function (res) { 
switch (res.err msg) { 
case 'send email:ok': 










































































alert (' 
调用 成 功 
break; 
case 'send email:cancel': 
alert(' 
用 户 取 消 ') 
break; 
case 'send email:fail': 
alert('" 
调用 失败 
case 'send email:confirm': 
alert('" 
确认 '); 
break; 
} 
alert (res.err msg); 
}); 
} 
</script> 
<title> 
发 邮件 演示 </title> 
</head> 
<body> 





<p> 

点 击 下 面 的 按钮 发 邮件 </p> 

<input type=button value=" 
发 邮件 " onclick="sengdMail ();"> 
</body> 

</html> 





显示 效果 如 图 6-15 所 示 : 


主题 : 邮件 标题 


附件 : 轻 触 此 添加 图 片 、 视 频 等 文件 
通过 微 信 发 邮件 ， 真 是 高 上 大 ， 





图 0-15 


读者 可 以 用 微 信 扫描 下 面 的 二 维 码 查看 发 邮件 的 效果 : 





6.3.7 图 


卢 预 而 


代码 示例 : 


<1DOCTYPE 


<html> 
<head> 


HIML> 








<meta ht 
<me 
<me 
<me 





// 


[nt 


ta name="forma 





tp-equiv="Con 
ta name="viewport" 


Len 





t-Type" content="text/h 























全 局 变 
是 否 完 
为 已 完成 


winxinyJsi 








处 理 WeixinJS: 





二 





标记 为 1 


document 








成 初 


if ( 





始 化 ，0 
下 

















t-detec 


conten 


t="width=screen-wid 
tion" content="telephone=no" /> 





tml; 


charset=uti1 
th, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 





FE-8" /> 











t/javascript"> 


BridgeReady = 0; 


BridgeReady 
牛 ， 当 初始 化 完成 后 ， 将 winxinJsBriggel 


用 于 标识 WeixinJSBridge 





Ready 





leixinyJSsiI 





.addEventl 





'istener(' 











typeo 











winxinyJsi 








判断 Weixin 








tion Preview() { 
//// 
inJSBridge 











口 














台 化 ， 未 完成 直 








接 返 








false 








f (winxinyJs] 














t('WeixinJSBridge 





BridgeReady 


BridgeReady', 


function onl 


ta name="apple-mobile-web-app-capable" content="yes" /> 
<script type="text 











F WeixinJSBridge == "object" && 
BridgeReady = 1; 


) { 





typeo 


F WeixinJSI 





BridgeReady () 


{ 








Bridge.invoke == "": 





Function") 


{ 


未 初始 化 成 功 ') ; 


return false; 


WeixinJSBridge.invoke ("imagePreview",{ 
"current": "http://devweixin.sinaapp.com/demo/pics/1.jpg", 
"urls": ["http://devweixin.sinaapp.com/demo/pics/1.jpg", "http://devweixin.sinaapp.com/demo/pics/2.jpg", "http://devweixin.sinaapp.com/demo/pics/3.jpg"] 
},;function (zes){ 
alert (res.err msg); 





过 
} 
</script> 
<title> 
图 片 预览 演示 </title> 
</head> 
<body> 


<p> 

点 击 下 面 的 图 片 进行 预览 </p> 

<a onclick="preview();"> 

<img width="100%" src="./pics/1.jpg"/> 
</a> 

</body> 

</html> 


界面 如 图 6-16 所 示 : 


氮 击 下 面 的 图 请 进行 预 贞 


En 


| My | | | 
全 _ 启 .下 -yy 
| 
下 了 





图 0-10 


图 片 预览 页 面 ， 可 以 缩小 和 放大 ， 如 图 6-17 所 示 。 


i 


| 电击 


| 
En, 
i 


T 


ee . 





读者 可 以 用 微 信 扫 描 下 面 的 二 维 码 查 看 发 邮件 的 效果 : 





下 呈 





再 小 的 个 体 ， 也 有 自己 的 品牌 。 


俗话 说 “ 民 以 食 为 天 ”， 团 购 、LBS 及 O2O 等 热门 互联 网 服务 都 最 先 从 餐饮 行业 寻找 突破 。 而 餐饮 行业 本 身 的 竞争 非常 激烈 ， 从 业者 需要 借助 互联 网 带 来 客流 。 典 型 的 例子 是 前 段 时 间 非 常 火 的 新 
闻 ，“IT 男 市 着 肉 来 馈 杀 回 五 道口 ”，|T 男 借 着 社交 网 络 的 传播 力 及 影响 力 ， 迅 速 打出 了 名 声 。 


餐饮 行业 一 直 与 互联 网 走 得 很 近 。 从 Web 1.0 的 网 站 时 代 就 有 网 上 订餐 ， 顾 客 可 以 查看 优惠 信息 、 浏 览 菜单 、 选 择 菜 品 ， 鼠 标点 几 下 就 能 完成 订餐 或 座位 预约 。 后 来 商家 发 现 通 过 QQ 或 QQ 群 订 餐 是 一 
种 不 错 的 选择 。 这 种 方式 不 需要 架设 服务 器 及 部 署 网 站 等 额外 资源 ， 还 能 和 顾客 沟通 聊天 ， 即 时 获取 反馈 ， 特 别 适 合 外 卖 服务 。 智 能 终端 普及 后 ， 各 种 餐饮 类 的 App 成 为 新 的 宠儿 。 


微 信 公众 平台 为 餐饮 行业 提供 了 另 一 个 选择 。 商 家 不 需要 去 开发 与 维护 一 个 手机 AppPp， 可 以 直接 用 微 信 公众 平台 进行 客户 关系 管理 、 提 供用 户 服务 等 。 顾 客 也 不 用 去 下 载 安 装 App， 只 须 使 用 微 信 “ 扫 
一 扫 ” 即 可 关注 商家 。 更 重要 的 是 ， 微 信 公 众 平台 提供 了 一 些 很 有 用 的 接口 服务 ， 经 过 简单 开发 ， 商 家 就 可 以 实现 手机 App 所 具有 的 功能 


本 章 介绍 一 个 餐厅 管家 的 应 用 ， 包 括 预约 管理 、 菜 单 管理 、 如 何 利用 二 维 码 进行 促销 及 路 线 导 航 等 
主要 用 到 微 信 公众 平台 的 以 下 接口 : 


生成 带 参 数 的 二 维 码 ， 用 来 生成 促销 二 维 码 。 


.消息 接口 ， 用 来 输出 用 户 服务 信息 
* 微 信 JS 接口 。 


“ 地 理 位 置信 息 服 务 。 


` 事件 推送 。 


另外 会 用 到 HTML 5 的 WebSocket 编 程 和 腾讯 地 图 的 地 图 APIl。 


7.1 功能 设计 
7.1.1 需求 分 析 


假设 作者 开 了 一 家 连锁 饭店 ， 叫 “兔子 饭庄 ”。 生 意 太 好 了 ， 就 在 海 深 、 朝 阳 、 东 城 、 西 城 、 昌 平等 地 都 开 了 分 店 。 为 这 样 一 个 饭店 开发 微 信 公众 平 台 ， 需 要 完成 哪些 事情 呢 ? 作 者 列 了 个 清单 : 
“ 预约 座位 。 这 个 太 重 要 了 ， 以 前 需要 打 电 话 ， 现 在 通过 微 信 可 以 完成 。 还 能 查询 自己 最 近 的 预约 情况 。 

` 点 菜 。 通 常 每 器 只 有 一 份 菜单 。 多 人 聚会 时 ， 大 家 需要 轮流 传 闲 。 有 了 微 信 ， 每 人 都 能 看 到 可 以 提供 的 菜肴 清单 。 对 于 饭店 工作 人 员 来 说 ， 维 护 电子 版 菜单 的 成 本 要 小 得 
. 优惠 券 。 利 用 二 维 码 进 行 促销 是 个 不 错 的 尝试 。 用 户 可 以 拍 下 二 维 码 ， 用 微 信 “ 扫 一 扫 ” 即 可 使 用 ， 是 不 是 很 方便 ? 


` 免费 Wifi。 在 饭店 门口 放 一 个 Wifi 标 志 ， 很 能 吸引 路 过 的 客人 。 如 果 客 人 刚好 想 去 吃饭 ， 为 何不 选 个 有 Wifi 的 地 方 呢 ?而 且 想 用 Wiff， 需 要 先 关注 兔子 饭庄 的 公众 账号 。 这 也 是 推广 公众 账号 的 一 个 方 


. 路 线 导航 。 读 者 或 许 有 过 这 样 的 经 历 : 一 群 人 去 聚会 ， 有 人 找 不 到 饭店 ， 需 要 打 电 话 告知 路 线 。 路 线 导 航 功 能 解决 了 这 个 问题 ， 发 送 你 的 位 置 ， 公 众 平台 就 能 给 你 发 送 路 线 图 。 
. 兔子 饭庄 介绍 。 介 绍 一 下 兔子 饭庄 的 相关 情况 。 
. 管理 后 台 。 供 饭店 工作 人 员 来 管理 上 述 事情 。 


图 7-1 就 是 微 信 公 众 平台 的 自 定义 菜单 ， 简 单 明 了 地 告诉 用 户 ， 公 众 平台 能 做 的 事情 。 


伯 患 鼻 


免费 WIFI 


路 线 导 航 


泡子 饭庄 





J 


7.1 功能 设计 


7.1.1 需求 分 析 
假设 作者 开 了 一 家 连锁 饭店 ， 叫 “兔子 饭庄 ”。 生 意 太 好 了 ， 就 在 海淀 、 朝 阳 、 东 城 、 西 城 、 昌 平等 地 都 开 了 分 店 。 为 这 样 一 个 饭店 开发 微 信 公 众 平台 ， 需 要 完成 哪些 事情 呢 ? 作者 列 了 个 清单 : 
* 预约 座位 。 这 个 太 重 要 了 ， 以 前 需要 打 电 话 ， 现 在 通过 微 信 可 以 完成 。 还 能 查询 自己 最 近 的 预约 情况 。 
. 点 菜 。 通 常 每 桌 只 有 一 份 菜 单 。 多 人 悄 会 时 ， 大 家 需要 轮流 传 闵 。 有 了 微 信 ， 每 人 都 能 看 到 可 以 提供 的 菜 戎 清单 。 对 于 饭店 工作 人 员 来 说 ， 维 护 电子 版 菜单 的 成 本 要 小 得 多 。 
优惠 券 。 利 用 二 维 码 进行 促销 是 个 不 错 的 尝试 。 用 户 可 以 拍 下 二 维 码 ， 用 微 信 “ 扫 一 扫 ” 即 可 使 用 ， 是 不 是 很 方便 ? 


` 免费 Wif。 在 饭店 门口 放 一 个 Wi 标志， 很 能 吸引 路 过 的 客人 。 如 果 客 人 刚好 想 去 吃饭 ， 为 何不 选 个 有 Wf 的 地 方 呢 ?而 且 想 用 Wif， 需 要 先 关 注 免 子 饭 庄 的 公众 账号 。 这 也 是 推广 公众 账号 的 一 个 方 


. 路 线 导航 。 读 者 或 许 有 过 这 样 的 经 历 : 一 群 人 去 聚会 ， 有 人 找 不 到 饭店 ， 需 要 打 电 话 告知 路 线 。 路 线 导 航 功能 解决 了 这 个 问题 ， 发 送 你 的 位 置 ， 公 众 平台 就 能 给 你 发 送 路 线 图 。 
" 免 子 饭庄 介绍 。 介 绍 一 下 兔子 饭庄 的 相关 情况 。 
. 管理 后 台 。 供 饭店 工作 人 员 来 管理 上 述 事情 。 


图 7-1 就 是 微 信 公众 平台 的 自 定义 菜单 ， 简 单 明了 地 告诉 用 户 ， 公 众 平 台 能 做 的 事情 。 


伯 患 鼻 


免费 WIFI 


路 线 导 航 


eT 





7.1.2 ”功能 演示 


号 


一 个 好 的 微 信 公 众 账 号 ， 其 核心 功能 要 放 在 自 定义 菜单 的 显著 位 置 。 对 于 餐饮 类 的 微 信 公众 账号 而 言 ， 不 同类 型 的 餐饮 行业 侧重 点 不 同 。 团 购 类 重 优惠 ， 品 牌 类 重 宣传 ， 家 常 类 重 功能 。 免 子 饭庄 属于 


家 常 类 ， 需 要 突出 功能 。 利 用 公众 账号 能 完成 预约 、 点 菜 、 获 取 Wifi 密 码 ， 必 要 时 能 给 出 路 线 导航 。 下 面 介绍 一 下 常见 功能 。 


1. 新 用 户 关注 


新 用 户 关注 时 ， 通 常 需 要 一 句 问候 语 ( 见 图 7-2) 。 





四 ”您 好 ,欢迎 关注 兔子 饭庄 。 


请 填写 预约 信息 ， 我 们 会 为 您 预 留 座 
位 


© 400-400-1234 > 





请 输入 姓名 





人 效 


05/30/2014 12:00 


手机 


海淀 总 庄 


Ea Fe Fs 


欢迎 您 在 免 子 饭庄 预约 座位 ， 为 了 我 们 对 您 的 服 芳 ， 
请 十 与 丰 习 信息 。 

如 果 您 不 能 按时 到 达 本 店 ， 我 们 会 联系 您 并 将 预约 时 

上 国 延 长 30 分 砷 ， 之 后 将 不 和 册 预 留 。 








如 果 近 期 内 有 预约 ， 则 显示 最 近 的 预约 单 ( 见 图 7-4) 。 


预约 人 : 由 先生 
人 数 ; 5 
用 餐 时 间 : 05 月 30 日 12:30 
电话 : 13112341234 


分 店 : 海 琵 总 店 
地 址 : 中 国 北 京 市 海淀 区 海 演 大街 38 号 
如 果 您 有 任何 意见 或 建议 ， 欢 迎 来 电 
兔子 饭庄 服务 电话 : 400-400-1234 





点 击 “ 点 菜 ” 按 钮 ， 出 现 菜 单 ( 见 图 7-5) 。 


还 可 以 按照 种 类 来 筛选 ( 见 图 7-6) 。 

















4. 优 惠 券 


扫描 优惠 券 二 维 码 ， 会 出 现 该 优惠 券 的 信息 ( 见 图 7-7) 。 


如 果 优 惠 券 通过 验证 并 且 人 允许 使 用 ， 则 会 返回 使 用 成 功 的 提示 ( 见 图 7-8) 。 








国 


5. 免 费 Wifi 


免费 Wifi 页 面 是 一 个 图 文 页 面 ， 可 以 在 微 信 公 众 平 台 编辑 ( 见 图 7-9) 。 


( 为 免 子 饭庄 WIFI 密码 





免 子 饭庄 WIFI 密码 ， 


2014=05=10 前 于 





尽情 孚 用 





WIFI 密码 为 : meiyoumima 
效 期 : 2014 年 4 月 10 日 -5 月 10 日 
请 勿 泄露 ， 谢谢 您 的 合作 







6. 路 线 导 航 


路 线 导 航 可 以 给 出 从 用 户 所 在 地 到 饭店 的 路 线 图 ， 并 有 多 种 换 乘 策略 的 路 线 ( 见 图 7-10) 。 








= 问 上 子 校 

















全 华北 电力 大 学 
地 三 合 通 。 本 |X0 
NN , 2 姜 礼 三 街 
ue 路 HN 
ee a 二 同 成 街 eg 一 
Re 新 龙 乡 商 坟 
所 E13 
合龙 观 镇 泽 % 轮 忘记 
en 自 三 旗 百 汇 商品 城 
LW 腾讯 地 臣 ®2014Tencent - .GS(20%4)6026 号 
方案 1. 


占 西 北 步行 约 960 米 ， 到 达 私 营 乡 北 
磁 举 996 ,经 过 16 站 ， 到达 页 昌 路 回龙观 
器 西 步行 约 1390 米 ， 到 达 终 点 

方案 2. 
回 西 步行 约 700 米 ， 到 达 翟 营 多 
来 学 681， 绎 过 1 站， 到 这 痢 沙 志 


通过 图 文 消息 ， 介 绍 企业 的 相关 情况 ( 见 图 7-11) 。 


4 和 久子 银 庄 侍 业 介绍 





兔子 饭庄 企业 介绍 


2014-05-10 竟 子 





锡 子 煞 庄 创立 于 2012 年 12 月 ， 运 今 为 止 有 将 
证 、 朝 阳 、 昌平 、 钙 况 村 多 冢 分 后 。 菜 关 品类 
每 多 ， 味 道 鲜 美 ， 值 得 您 的 光临 。 

地 址 : 

海 浅 总 店 ”中国 北京 市 海 沁 区 海 证 大 街 38 己 
办 阳 一 分 店 ”中 国 北 京 市 埋 阳 区 坦 阳 公园 南路 2 





昌平 二 分 店 “中国 北京 市 昌平 区 回龙观 镇 回 龙 
观 村 
西城 三 分 店 “中国 北京 市 西城 区 白云 路 临门 7 号 





图 7-11 


7.1.3 ”注意 事项 


本 节 介 绍 为 兔子 饭庄 开发 的 “餐厅 管家 ”的 具体 实现 。 “餐厅 管家 ”实现 了 预约 管理 、 菜 单 管理 、 优 惠 券 管理 、 路 线 导航 和 相关 服务 介绍 ， 满 足 了 餐饮 类 公众 账号 的 一 般 需 求 。 值 得 注意 的 是 ， 由 于 本 
书 重点 探讨 微 信 公众 平台 相关 的 开发 ， 所 以 有 以 下 约定 : 


. 未 使 用 任何 PHP 框 架 。 为 了 降低 大 多 数 读者 的 学 习 成 本 ， 本 节 未 使 用 任何 PHP 框 架 ， 都 是 原生 态 PHP。 


. 使 用 SAE 平 台 ， 兼 容 其 他 平台 。 本 节 的 例子 在 SAE 平 台 调 斌 通过。 采用 SAE 的 原因 是 稳定 、 易 用 。 如 果 通 过 了 开发 者 认证 ， 可 以 免费 使 用 资源 。 同 时 为 了 兼容 其 他 平台 ， 未 过 多 使 用 SAE 特 有 的 服务 ， 
开发 者 能 轻松 移植 到 其 他 平台 。 


` 本 节 有 管理 后 台 的 开发 ， 但 权限 管理 、 账 户 体 系 等 功能 是 通用 的 开发 需求 ， 故 本 节 不 做 过 多 探讨 。 读 者 如 需 用 于 实际 项 目 ， 请 自行 添加 相关 逻辑 。 


由 于 篇 幅 限 制 ， 与 微 信 公 众 平台 开发 无 关 的 功能 与 文件 在 本 书 中 没有 殴 述 ， 读 者 可 以 在 华章 网 站 (www.hzbook.com) 下 载 。 


7.2 “餐厅 管家 ”的 实现 


本 节 介 绍 “ 餐 厅 管 家 ”的 编码 实现 。 首 先 要 创建 自 定 义 菜 单 ， 然 后 依次 介绍 预约 管理 、 菜 单 管理 、 优 惠 券 二 维 码 、 路 线 导航 等 功能 实现 。 


7.2.1 目 定 义 荣 单 


菜单 项 的 配置 如 表 7-1 所 示 : 


陆 约 CLICK RESERVE 预约 座位 
点 沫 http://url.cn/NLGykEA 订单 






服务 绢 出 菜单 葬 
优惠 劳 view 优惠 券 管理 


这 里 使 用 程序 来 创建 自 定义 菜单 。 





File: dine/create menu.php 

<?php 

require "lib/weixin.class.php";// 
引入 微 信 类 文件 
//Smenu 


变量 为 存放 菜单 项 的 json 
字符 串 





























"name™ . 1 
点 菜 "， 
Wurl": "http://url.cn/NLGyKA" 
}, 


"name" 。 
服务 "， 
"sub button": [ 

{ 


"type"™ 。 "view", 
1 name 至 。 1 
优惠 券 "， 
wurl™": "http://url.cn/ONDMNV" 
}, 
{ 
"type" : "view", 
1 name 1 。 1 





免费 WIFI"， 
"ur1l": "http://url.cn/KOGNm]j" 
}, 
{ 


"type": "click", 








"mame™ : 1 
路 线 导 航 "， 
"key™": "CLICK _ ROUTE" 
}, 
{ 
"type" : yliew" > 
有 人 em 。 mw 
兔子 饭庄 "， 





"url": "http://url.cn/L7JNC2" 


ji 
$ret = Weixin: :createMenu ($menu);// 
创建 菜单 

if($ret) {// 

创建 成 功 

echo "ctreate menu ok'; 

}else{// 
创建 失败 


echo 'create menu fail'; 
} 


?> 














创建 自 定义 菜单 的 关键 是 创建 存放 菜单 项 的 json 字 符 串 。 这 里 有 两 种 方法 : 
.json_encode。 读 者 可 以 创建 数组 ， 然 后 使 用 php 的 json_encode 方 法 将 数组 转换 为 json 字 符 串 。 


. json 编 辑 器 。 这 里 推荐 一 个 在 线 json 编 辑 器 http://jsoneditor.duapp.com， 读 者 可 以 通过 可 视 化 工具 编辑 好 之 后 ， 再 放 到 程序 中 运行 。 本 节 采 用 此 方法 。 


7.2.2 ”数据 库 操作 类 封 狼 
本 书 黑 认 在 SAE 上 开发 ， 但 为 了 兼容 其 他 平台 ， 我 们 需要 对 数据 库 操 作 类 进行 封装 。 封 装 后 的 数据 库 操 作 类 可 以 自行 判断 运行 平台 ， 如 果 在 SAE 上 运行 ， 则 启用 SAE 的 MySQL 服 务 ; 如 果 在 其 他 平台 上 
运行 ， 则 启用 兼容 SAE MySQL 的 服务 。 读 者 在 使 用 时 无 顷 关注 细 节 ， 采 用 统一 的 方法 即 可 。 
与 数据 库 操作 类 相关 的 文件 有 : 
. diner/model/SaeDB.class.php: 单 例 模式 获取 MySQL 实 例 类 
. diner/model/dbconfigphp: 数据 库 配 置 文件 
. diner/model/saemysql.class.php: 兼容 SAE MySQL 类 


当 需 要 使 用 MySQL 服 务 时 ， 只 须 调 用 如 下 语句 : 





include 'pathto /SaeDB.class.php'; 
smysql = SaeDB: :getInstance () ， 











SaeDB.class.php 的 完整 代码 如 下 : 


<?php 
/** 


克 
单 例 模式 获取 MySQL 
实例 类 
*/ 
class SaeDB{ 
private static $mysql; 
private function construct() { 
echo "Not allowed"; 

















} 
public static function getInstance () { 

if (!isset(seLf::Smysal)) f{ 

if(isset($ SERVER['HTTP APPNAME'])){//SAE 










































































平台 
self::S$mysgql=new SaeMysgql (); }; 
}else{// 
其 他 平台 
self::$mysql= self::1oaqSAEMysql (); 














} 
} 


return self::S$mysqgl; 





} 
private static function loadSAFEMysql() { 
require 'dbconfig.php';// 
数据 库 配 置 文件 
require 'saemysqgl.class.php';//SAE mysqgl 
兼容 类 


} 










































































return new SaeMysql ($saeDBConfig['host'],$saeDBConfig['username'],S$saeDBConfig['pass'],$saeDBConfig['db'],$saeDBConfig['port"']); 


其 中 $_SERVER['HTTP_APPNAME'] 是 SAE 平 台 特 有 的 服务 器 信息 ， 可 以 用 来 判断 当前 环境 是 否 为 SAAE。 如 果 不 是 SAE， 需 要 手动 加 载 数据 库 配 置 文 件 和 和 SAE MySQL 兼容 类 。 


数据 库 配 置 文件 dbconfig.php 的 完整 代码 如 下 : 


<?php 
/** 


数据 库 配 置 ， 如 果 使 用 SAI 








[9 


























则 不 需要 配置 

*y 

$saeDBConfig['host'] = 'localhost'; 
$saeDBConfig['username'] = 'root'; 
$saeDBConfig['pass'] = "''; 
$saeDBConfig['db'] = "''; 
$saeDBConfig['port'] = 3306; 


dbconfig.php 文 件 定义 了 一 个 saeDBConfig 数 组 ， 用 来 配置 数据 库 的 主机 名 、 用 户 名 


SAE MySQL 兼 容 类 saemysql.class.php 的 完整 代码 如 下 : 



















































































、 密 码 、 数 据 库 和 端口 。 


<?php 
/** 
a SAE 
兼容 MySQL 
务 
*/ 
/** 
* Sae Mysql Class 
大 
* <code> 
* <?php 
* Smysql] = new SaeMysql ('localhost','root','pass', 'dbname'); 
大 
* $sql = "SELECT * FROM ‘user LIMIT 10"; 
* $data = $mysql->getDatal( $sql ); 
* Sname = strip tags( $ REQUEST['name'] ); 
* $age = intval( $ REQUEST['age'] ); 
* $sql = "INSERT INTO user (‘name’ , "age ` ，regtime )VALUES('".s$mysql->escape 
($name) ."', '™" . intval( $age ) . "' , NOW() ) "; 
* Smysql->runSgl( $sql ); 
* if( Smysql->errno() != 0 ) 
* 
* Qie( "Error:" . $mysql->errmsg() ); 
区 
大 
* Smysql->closeDb () ， 
* ?> 
* </code> 
大 
*/ 
class SaeMysqgql 
{ 
/** 
大 
构造 函数 


* Qparam type $host 


* @param type $username 











数据 库 用 户 名 

* Qparam type S$pass 
密码 

* Qparam type Sqb 
数据 库 名 称 

* Qparam type Sport 
端口 








* QQparam bool $do replication 
是 否 文 持 主 从 分 离 ，true: 


支持 ，false: 





















































不 支持 ， 默 认为 true 
A 
function construct( $host = 'localhost', $username = 'root', $pass = 
{ 
Sthis->port = S$port; 
Sthis->host = $host; 
Sthis->accesskey = $username; 
$this->secretkey = S$pass; 
Sthis->appname = $db; 
//set default charset as utf8 
Sthis->charset = 'UTF8'; 
$this->do replication = $do replication; 
} 
/** 
大 
设置 keys 
’ 
bs 
当 需 要 连接 其 他 APP 
的 数据 库 时 使 用 
大 


Qparam string Sakey AccessKey 





Qauthor EasyChen 











public function setAuth( Sakey , S$skey ) 
{ 











$sthis->accesskey = Sakey; 
Sthis->secretkey = $skey; 
} 
/ 大 大 
类 
设置 MySQL 
服务 器 端口 
大 


大 


当 需 要 连接 其 他 APP 
的 数据 库 时 使 用 











* Qparam string S$port 

* Qreturn void 

* Qauthor EasyChen 

*/ 
public function setPort( Sport ) 


{ 














33073 
= '.rdc.sae.sina.com.cn'; 


this->por 
this—>hosi 


二 








} 
/** 

党 
设置 Appname 
es 
大 


当 需 要 连接 其 他 APP 
的 数据 库 时 使 用 


* Qparam string $appname 
* Qreturn void 
* Qauthor EasyChen 




















public function setAppname ( Sappname ) 


$this->appname = 'app ' . $appname; 
设置 当前 连接 的 字符 集 ， 
必须 在 发 起 连接 之 前 进行 设置 
大 
































* Qparam string $charset 
字符 集 ， 


'', $db = '', $port = 3306, $do replication 


true ) 


如 GBK, GB2312,UTF8 
* Q@return void 


*y 
public 
{ 


} 
/** 


大 


return $this->set _ charset ( $charset ); 








同 setCharset， 

















向 前 兼容 


大 





* Qparam string $charset 


* Q@return void 
* Qignore 


BA 
public 
{ 





function setCharset( $charset ) 


function set charset( $charset ) 


Sthis->charset = S$charset; 


} 
/** 
大 
运行 SQL 
语句 ， 
不 返回 








十 EE 




















攻 
大 
ve 


证 术 索 


GParam si 


tring $sql 





* @return mysqli result|boo] 











Function runSgql( $sql ) 








return S$this->run sgql( $sql ); 


} 





























/** 
大 
同 runSsql， 
回 醒 莫 众 
大 
* Qparam string $sql 
* Q@return bool 
* Qauthor EasyChen 
* Qignore 
4 
public func 





tion run sql( $sql ) 





{ 

















return false; 


} 


$ret = mysq] 





$this->last Sql = $sql; 
$dblink = $this->db write(); 
if ($dblink === false) { 


Li query( $dblink, $sql ); 


$this->save error( $dblink ); 
return $ret; 


} 


/** 
Se 


运行 SOL， 


以 多 维 数组 方式 返回 结果 集 








* Qparam string $sql 
* Qreturn array 


成 功 返 回 数组 ， 失 败 时 返回 false 








* Qauthor 


Ry 








EasyChen 











public func 


{ 


tion getData( $sql ) 


return Sthis->get datal( $sql ); 


} 


/** 


同 getData, 














向 前 





容 





大 


* Qignore 
#7 


public function get data( $sql ) 


{ 


$this->last sql = $sql; 








= $this->do replication ? $this->db read() 





$data = Array (); 

$i = 0; 

Sdblink 

if (Sdblink === false) { 
return false; 








} 


$result 





= mysqli query( $dblink , $sql ); 
Sthis->save error( $dblink ); 











} else 


while( $Array = mysqli | 


} 
} 


{ 


if (is bool ($result)) { 
return Sresult; 





$data[$i++] = $Array; 











mysqli 1 
if( count( $data ) 
return S$data; 





else 








return NULL; 


} 


/** 
A 


运行 SQL, 
以 数组 方式 返回 结果 集 第 一 条 记录 


public func 


同 get 




















* Qparam si 














tring $sql 


* Qreturn array 
成 功 返 回 数组 ， 失 败 时 返回 false 


* Qauthor EasyChen 








&/ 

















{ 


free result ($result); 
>0) 


tion getLine( $sql ) 


return Sthis->get line( $sql ); 

















向 前 





GParam si 





尖 
大 
* Qreturn array 
大 
大 


tring $sql 


Qauthor EasyChen 


@ignore 


2 





public function get line( $sql ) 


{ 

















$data = $this->get gat 
if ($data) { 

return Qreset ($da 
} else { 

return false; 





} 
/** 


大 


行 SQL, 




















* Qparam string $sql 


ta( $sqgl ); 





ta); 


运 
返回 结果 集 第 一 条 记录 的 第 一 个 字段 值 
大 


: Sthis->qb write () ; 


Fetch array( $result, MYSQOL ASSOC ) ) 


* Q@return mixxed 
成 功 时 返回 一 个 值 ， 失 败 时 返回 false 
* Qauthor EasyChen 
Wh 
public function getVar( $sql ) 
{ 


} 


/** 















































return Sthis->get var( $sql ); 


同 getvar, 
回击 




















Qparam string $sql 
Qreturn array 
Qauthor EasyChen 
@ignore 





a 





public function get var( $sql ) 


{ 





$data = Sthis->get line( $sql ); 

















if ($data) f{ 

return $datal[l Qreset (Qarray keys( $data )) 1]; 
} else { 

return false; 





} 








/** 
大 
同 mysqli affected rows 
函数 
大 
* @return int 
成 功 返回 行 数 ， 
失败 时 返回 -1 
* Qauthor Elmer Zhang 
2 
public function affectedRows () 
































$result = isset (Sthis->qb write) ? mysqli affected rows( Sthis->qb write ) 








return Sresult; 





} 
/** 


同 mysqli insert id 
函数 
大 


* Qreturn int 
成 功 返 回 last id， 








失败 时 返回 false 
* Qauthor EasyChen 
* 
public function LastId() 

















return S$this->last id(); 





} 

/** 

* 
同 lastIq, 
问 击 莱 容 


大 























* Q@return int 
* Qauthor EasyChen 
* Qignore 
wf 

public function last id() 


{ 




















$result = mysqli insert id( $this->db write( false ) 
return $result; 








} 
/** 


关闭 数据 库 连 接 











* Q@return bool 
* Qauthor EasyChen 














public function closeDb() 








return Sthis->close db(); 
} 
/** 
大 
同 closeDb, 
问 醒 腾 容 


大 




















* Q@return bool 
* Qauthor EasyChen 
* Qignore 
4 

public function close gb() 


{ 




















if( isset( $this->db read ) ) 
Qmysqli close( $this->db read ); 
if( isset( $this->db write ) ) 
Qmysqli close( Sthis->qb write ); 





























0 


} 
/** 
大 
同 mysqli real escape string 
* Qparam string $str 


* Qreturn string 
* Qauthor EasyChen 














public function escape( $str ) 














if( isset($this->db read) ) { 
$db = $this->db read; 

} elseif( isset($this->db write) ) { 
$db = $this->db write; 

} else { 
$db = $this->db read(); 





return mysqli real escape string( $db , $str ); 


} 























/** 
大 
返回 错误 码 
大 
大 
* Qreturn int 
* Qauthor EasyChen 
2 
public function errno() 
{ 
return $sthis->errno; 
} 
/** 
大 
返 世 











错误 信息 
大 


* Qreturn string 

* Qauthor EasyChen 

大 
public function error () 


{ 
} 

















return S$this->error; 





); 


站 


/** 


大 











可 错误 信息 , error 


别名 


返 
的 





* Qreturn string 

* Qauthor EasyChen 

WA 
public 
{ 


} 











Function errmsg () 








return Sthis->error () 






































/** 
* Qignore 
yy 
private function connect( $is master = true ) 
{ 
if (Sthis->port == 0) f{ 
sthis->error = 13048; 
$sthis->errno = 'Not Initialized'; 
return false; 
f( $is master ) $host = 'w' . $this->host; 


lse $host = 'r' . S$this->host; 
mysqli init(); 
mysqli options ($db, MYSOLI OPT CONN 
if( !Imysqli real connect( 8 
secretkey , S$this->appname , $th 
{ 








ECT TIN 























is->port ) ) 











Sthis->error = mysqli connect error(); 
$this->errno = mysqli connect errno(); 
return false; 





} 
mysqli set charset( $db, S$this->charset); 
return $db; 
} 
/** 
* Qignore 
*/ 





func 





priva 


{ 


te tion db read() 














t(S 


f( isse 


一 PP- 





return $this->db read; 


£f( !Sthis->qo replication ) 
lse 














$this->db read = Sthis->connect ( 
return $this->db read; 


/** 


* Qignore 








func 





te tion db write( $reconnect = true ) 














&& ( S$reconnect == 


TIMEOUT, 5); 
sdb, S$this->host , S$this->accesskey ， $this-> 


this->db read ) && mysaqli ping( Sthis->qb read ) ) 


return Sthis->qb write(); 


false );} 








f( isset( $this->db write ) 








return $this->db write; 
} 
else 


{ 


$this->db write = $this->connect( true ); 
return $this->db write; 


} 
/** 


* Qignore 





Function 





te save error ($dblink) 





mysqli error ($dbli 
mysqli errno ($dbli 


this->error 
this->errno 











te Serror; 
te S$errno; 
te Slast Sql; 





7.2.3 ”做 人 襄 朋 息 接 


false || mysqli ping( $this->db write ) ) ) 


首先 我 们 需要 接 入 微 信服 务 器 ， 才 能 接收 微 信服 务 器 发 送 的 数据 ， 并 将 处 理 结果 返回 给 微 信服 务 器 。 与 之 相关 的 文件 有 : 


“ diner/api.php: 微 信 消息 接口 URL 


.dinetr/lib/common.func.php: 常用 函数 
. diner/lib/defaultweixin.php: 微 信 消息 响应 类 


diner/model/SendMsgDB.php: 微 信 消息 数据 库 操 作 类 


api.php 文 件 作 为 开发 服务 器 与 微 信服 务 器 之 间 的 接口 ， 负 责 接收 微 信 服务 器 发 送 的 数据 ， 并 将 之 传递 给 微 信和 


回 不 同 的 响应 信息 。 


api.php 完 整 代码 如 下 : 


File: qiner/api.php 

















<?php 

/** 

2 
微 信 消 息 接 口 URL 

7 

require 'lib/common.func.php'; 
require 'lib/defaultweixin.php'; 
Sweixin = new DefaultWeixin (); 











Sweixin->run (); 
exit (0);} 


common.func.php 实 现 了 一 些 常用 的 函数 ， 完 整 代 码 如 下 : 


File: qiner/api.php 
<?php 


/** 
大 





肖 息 响应 类 。Defaultweixin.php 负 责 具体 业务 处 理 ， 根 据 用 户 发 送 的 不 同类 型 的 数据 ， 返 


微 信 消息 接口 URL 

*7 
require 'lib/common.func.php'; 
require 'lib/defaultweixin.php'; 
Sweixin = new DefaultWeixin ();} 
Sweixin->run ();} 
exit (0) ， 
common .func .Php 
实现 了 一 些 常用 的 函数 ， 完 整 代 码 如 下 : 


File: diner/ lib/common.func.php 















































* Qparam type Smsd 





function sae log ($msg){ 
sae set display errors (false);// 
关闭 信息 葵 出 “ 加 
sae debug ($msg);// 
记录 日 志 
sae set display errors(true);// 
记录 日 志 后 再 打开 信息 输出 ， 否 则 会 阻止 正常 的 错误 信息 的 显示 
ee 


大 

获取 当前 时 间 ， 精 确 到 微 秒 
* Qreturn type 

*/ 


function microtime float() 































































































list($usec, $sec) = explode(™ ", microtime()); 
return ((float)S$usec + (float)$sec); 











} 
/** 


大 
获取 文件 扩展 名 
* Qparam type $filepath 
* Qreturn type 
4 
function get file ext ($filepath){ 
return substr ($filepath, strrpos ($filepath, 












































} 













































































/** 
大 
加 载 文 件 
* Qparam string $path 
大 
/ 
function lipbfile ($path) { 
list($folder , $file) = explode("/", $path, 2); 
if(substr ($file, -4) == '.php')t{ 
$path = BASEDIR . "/{$folder}/{$file}"; 
}elselt 
$path = BASEDIR . "/{$folder}/{$file} .php"; 


} 
return $path; 
} 


/** 
大 


保存 文件 到 SAE 
* Qparam type $imgbin 
* Qparam string $destrFileName 
* Qreturn type 
5 
function savetosae ($imgbin, $destFileName=")1 
$storage = new SaeStorage (); 
Sdomain = 'devweixin'; 
if(!S$destFileName)t 
$sdestFileName = md5 (time()).'.jpg'; 


























} 


Sattr = array('encoding'=>'gzip'); 





return $storage->write ($domain, $destFileName, $imgbin, -1, S$attr, 


defaultweixin.php 负 责 处 理 微 信 消 息 ， 并 返回 响应 结果 。 


<?php 
/** 


微 信 消 息 响 应 
针对 用 户 发 送 的 不 同类 型 的 数据 ， 返 回 不 同 的 响应 信息 


require libfile('lib/weixin.class.php'); 
require libfile('model/SendMsgDB .php'); 
class DefaultWeixin extends weixin { 
private $sendmsg;// 
消息 处 理 模 型 
private S$process time; 
public function processRequest ($data) { 


$time start = microtime float();// 
开始 计时 

$this->sendmsg = new SendMsgDB();// 
te 


判断 并 处 理 文本 消息 
if (S$this->isTextMsg()) 1 














































































































//$input 
为 用 户 输入 的 内 容 





Sinput = $data->Content; 
Switch ($input) { 
defauilt: 
$sthis->text ($input); 
break; 








} 

A 
判断 并 处 理 地 理 位 置 消息 
else if ($this->isLocationMsg()) { 
suserLlocData = Sdatas 













































































$ 
$ 
$ 
$sthis->goroute ($data); 


人 一 


























判断 并 处 理 图 片 消息 
lse if (Sthis->isImageMsg()) { 


























判断 并 处 理 链接 消息 
se if (Sthis->isLinkMsg()) { 




















> 


// 
判断 并 处 理事 件 推 送 

else if (S$this->isEventMsg()) { 

Switch ($data->Event) { 
case 'subscribe': 
f (lempty($data->EventKey)) { 

$this->showar ($data, 0); 
} else { 


$sthis->text(' 
你 好 ， 欢 迎 关 注 兔子 饭庄 。') ; 
} 












































PP- 














break; 
case 'unsubscribe': 


一 一 
IUD 


yo) 


整 代码 如 下 : 


userLocData->addChild('Latitude', $data->Location X) 


userLocData->addChild('Longitude', $data->Location 
this->sendmsg->saveUserLocation ($data); 


) 


六 


true); 


sthis->text(' 




















户 取消 订阅 '); 
break; 
case 'VIEW': 
break; 
Case 'CLICK'"': 
Ssthis->click ($data); 
break; 
case 'SCAN': 
$ 
b 














this->showgr ($data, 1); 

reak; 

Case 'LOCATION': 
$sthis->sendmsg->saveUserLocation ($data); 




















break; 
defauilt : 
} 
} else if (S$this->isVoiceMsg()) 1 
// 
处 理 语音 信息 
} else { 

















处 理 其 他 消息 
} 














$time end = microtime float();// 
计时 结束 
Sthis->process time = $time end -$time start;// 
记录 处 理 时 间 
后 











分 类 处 理 点 击 事件 
* Qparam type $data 
微 信 消息 体 
< 
private function click($data) { 
SeventKey = $data->EventKey; 
Switch ($eventKey) 
Case 'CLICK RESERVE ' : 
$sthis->goreserve ($data); 
break; 
Case 'CLICK ORDER ' : 
break; 
Case 'CLICK ROUTE ' : 
SuserLoc = $this->sendmsg->getUserLocation ($data); 
sae log(var export ($userLoc, TRUE)); 
if (empty($userLoc)) { 


sthis->text(' 
【兔子 饭庄 路 线 导航 】 
试 试 发 送 你 的 位 置 ， 即 可 为 你 指引 到 各 个 分 店 线路 : 


1 
点 击 左下 方 “ 小 键盘 
2 


点 击 打字 窗口 旁边 的 \+ 
号 键 / 
35 
选择 "位 置 “图 标 
4. 
完成 定位 后 点 击 右 上 角 \ 发 送 “) ; 

} else { 

$sthis->goroute ($data); 

















TT [J 






































明寺 



























































} 
break; 
defauilt : 
$this->text (Var export ($data, TRUE)); 
break; 








} 
/** 


显示 路 线 导 航 页 面 
~ * @param type $data 
微 信 消 息 体 
2 


private function goroute (S$qata) { 


Stext = 
最 近 的 兔子 饭庄 路 线 ' ; 
$posts = array( 
array( 
'title' => ' 




















路 线 导航 '， 





'discription' => $text, 
‘picurl' => 'http://mmbiz.gqpic.cn/mmbiz/XWia2Xj7RZ8nxGcF147qJQjsmliagqf3SquP9ucVPEOoCCBFAibdicKtaCmbEZCLJcE5ib6gEKSZicjHSlySJclicrgicPHQ/0', 
'url' => 'http://devweixin.sinaapp.com/diner/route.php?user="' . $data->FromUserName, 



































) 
); 
$this->outputNews ($posts); 
} 
/** 
大 
显示 预约 页 面 
* Qparam type $data 
微 信 消息 体 
4 
private function goreserve($data) { 
$ret = $this->sendmsg->getRecentReserve ($data); 












































if (lempty($ret) && S$ret[l'dinertime'] > time() -1800) 1 
$posts = array( 
array ( 
'title' => ' 


你 最 近 的 预约 '， 


'discription' => ' 
































时 间 : ' . date('Y-m-d H:i', $ret['dinertime']). ' 
， 人 数 : ' . Sret['num']， 
'picurl' => 'http://mmbiz.qpic.cn/mmbiz/XWia2Xj7RZ8nxGcF147qJQjsmliaqf3SquWeLOBzAficTdkxo2oeV9PvVqvcUUj14pE40q5fAZx2s4TGsZIalZFCg/0', 
'url' => 'http://devweixin.sinaapp.com/diner/myreserve.php?user=' . $data->FromUserName, 
) 
); 
} else 
$posts = array( 
array( 
'title' => "' 


兔子 饭庄 精美 美食 等 着 你 哟 '， 
'discription' => ' 
现在 预约 吧 '， 





'picurl' => 'http://mmbiz.qpic.cn/mmbiz/XWia2Xj7RZ8nxGcF147qJQjsmliaqf3SquWeLOBzAficTdkxo2o0eV9PvVqvcUUj14pE40q5fAZx2s4TGsZIalZFCg/0', 
'url' => 'http://devweixin.sinaapp.com/diner/reserve.php?user="' . $data->FromUserName, 





























); 
} 
$this->outputNews ($posts); 
} 


/** 


显示 优惠 券 页 面 
* Qparam type S$data $data->EventKey 
的 值 与 type 
有 关 。 当 type=0 
时 为 qrscene 123123 
， type=1 
时 为 123123 
* Qparam type $type 0, 
未 关注 1 
关注 



































private function showar ($data, $type = 0) { 
if ($type == 0) { 

$sceneid = substr ($data->EventKey, 8); 
} else if ($type == 1) 1 

$sceneid = $data->EventKey; 




















} 
Stext = " 
使 用 优惠 券 '; 
$posts = array( 
array( 
'title' => "' 




















使 用 优惠 券 '， 








'discription' => $text, 
'picurl' => 'http://mmsns.gqpic.cn/mmsns/XWia2Xj7RZ8mhQaESostBicFaX2HjVBIPJYKKCBk9PkuicKrSZdfNL7XAw/0', 
'url' => 'http://devweixin.sinaapp.com/diner/showgr.php?sceneid=' . $sceneid . '&user="' . $data->FromUserName, 























) 
); 
$this->outputNews ($posts); 
} 
/** 
大 
图 文 消息 封装 
* Qparam type S$posts 











function outputNews ($posts = array()) { 

$xml = parent::outputNews ($posts); 
header ('Content-Type: application/xml'); 
echo $xml; 








yx- 
着 
沁 








返 











private function text ($text) { 
// outputText 
来 返回 文本 信息 
Sxml = Sthis->outputText ($text); 
header ('Content-Type: application/xml'); 
echo $xml; 






































~ 一 





} 

/** 

大 
a 
YJ1 二 


* Q@return boolean 

















protected function beforeProcess ($postData) { 
//sae lo0g(" 
处 理 之 前 ")， 
sae log (var export ($postData, true)); 
return true; 














/** 


大 


后 处 理 ， 一 般 会 包括 数据 上 报 























* Qreturn boolean 
x 
protected function afterProcess() { 
//sae lo0g(" 
处 理 之 后 ") ; 
sae log(" 
消耗 时 间 " . Sthis->process time) ; 


return true; 
} 
public function errorHandler ($errno, S$error, S$file = '', S$line = 0) f{ 
Smsd = sprintf('%s -$s -%s -$s', Serrno, S$error, S$file, $line); 
sae log ($msg); 


























} 

public function errorException (Exception S$e) { 
$msg = sprintf ('%s -%s -%s -%s', $e->getCode(), $e->getMessage(), $e->getFile(), $e->getLine()); 
sae log ($msg); 




















SendMsgDB.php 负 责 微 信 消 息 的 数据 库 操作 。 


<?php 
/** 
A 





include once 'SaeDB.class.php'; 
class SendMsgDB { 

private $db; 

public function construct() { 
$sthis->db= SaeDB::getInstance () ， 




















} 


/** 
Se 


保存 用 户 最 近 的 地 理 位 置 
* Qparam type $data 
































微 信 消息 体 
* Qreturn boolean 
*/ 


public function saveUserLocation($data) { 
$FromUserName=$this->db->escape ($data->FromUserName); 
SCreateTime= intval ($data->CreateTime); 

$Latitude=doubleval ( ($data->Latitude) ); 

$sLongitude=doubleval ($data->Longitude); 



























































$sql] = "UPDATE ‘dinner userlocs ”SET ‘Latitude = '{$Latitugde}', 
‘Longitude. = '{S$Longitude}', 
‘CreateTime’ = '{$CreateTime}' WHERE ‘dinner userlocs . 
‘FromUserName. ="'{S$FromUserName}';"; 


sthis->db->runSql( $sql ); 
f($this->db->affectedRows() < 1){//if update fails,then insert on 
$sql="INSERT INTO ‘dinner userlocs (‘id’, ‘Latitude’, ‘Longitude’, ‘FromUserName’, “createtime ) VALUES ". 
"(NULL, '{$Latitude}', '{$Longitude}', 
'{S$FromJserName}','$CreateTime 7 ) 7 "7 
$sthis->db->runSql( $sql ) 
if( $this->db->errno() != 0 ){ 
Sae log(" 
存 入 位 置信 息 失 败 ， 
错误 原因 为 : " .Sthis->qb->ertmsg() ." 
出 错 sql 
为 : ".$sql); 


























PP- 


















































return FALSI 





[5 
~。 


} 





return TRUE 


AN。 


} 




















/** 
大 
获取 用 户 最 近 位 置 
* Qparam type $data 
微 信 消息 体 
* Qreturn type 
*/ 
public function getUserLocation (Sdqata) { 








SETromUserName=Sthis->qb->escape ($data->FromUserName); 
$sql = "SELECT * FROM ‘dinner userlocs ”where FromUserName = '{$FromUserName}' order by “CreateTime ”qdqesc limit 1"; 
return S$this->db->getLine( $sql ); 




















} 
/** 


尖 
获取 用 户 最 近 预 约 情况 
* Qparam type $data 

















微 信 消息 体 
* Qreturn type 
«7 














public function getRecentReserve ($data) { 
$Sopenid=$this->db->escape ($data->FromUserName); 





$sql = "SELECT * 

FROM ‘diner reservVe 

WHERE ‘openid. LIKE '{$openid}' order by dinertime desc"; 
return S$this->db->getLine( $sqgl ); 









































7.2.4 预约 管理 
预约 管理 包括 两 个 功能 : 预约 和 查看 预约 信息 。 当 用 户 点 击 “ 预 约 ”菜单 项 时 ， 程 序 应 能 判断 该 用 户 近期 是 否 有 预约 ， 从 而 进行 不 同 的 处 理 。 本 节 介绍 一 下 具体 实现 。 
1 数据 表 设 计 


预约 管理 需要 一 张 表 来 存放 用 户 的 预约 信息 ， 表 的 结构 如 表 7-2 所 示 。 


字 段 名 字段 类 型 字段 描述 
Id Int 主键 标识 ， 目 增 
name varchar 客人 姓名 
SeX tinyint 客人 性 别 ，1 代 表 男 ，2 代 表 女 
num tinyint 束 餐 人 数 
dinertime int 束 和 餐 时 间 的 时 间 枚 
phone varchar 电话 
locid int 分 店 id 


openid varchar 用 户 的 openid， 用 作客 人 的 唯一 标识 


addtime timestamp 操作 时 间 


字段 locid 是 饭店 位 置信 息 表 的 主键 ， 唯 一 标识 一 个 分 店 。 字 段 addtime 记 录用 户 的 操作 时 间 ， 与 具体 业务 无 关 ， 但 记录 下 用 户 什么 时 间 操 作 有 助 于 分 析 用 户 的 使 用 习惯 ， 也 有 利于 在 出 现 问题 时 找 出 原 
因 。 


创建 预约 信息 表 的 代码 如 下 : 


表 的 结构 “diner reserve、 





























CREATE TABLE IF NOT EXISTS ‘diner reserve ( 
“id int(10) NOT NULL AUTO INCREMENT COMMENT ' 







































































主键 '， 

”name varchar (20) NOT NULL COMMENT ' 
姓名 '"， 

‘sex tinyint (1) NOT NULL COMMENT ' 
性 别 '， 

num tinyint (2) NOT NULL COMMENT ' 
就 餐 人 数 '， 

‘dinertime ”int(10) NOT NULL COMMENT ' 
就 餐 时 间 '"， 























“phone ”varchar (11) NOT NULL COMMENT ' 
电话 '， 
‘locid int(10) NOT NULL COMMENT ' 
分 店 id'， 
‘openid varchar (100) DEFAULT NULL COMMENT ' 
户 的 openid'， 
addtime timestamp NOT NULL DEFAULT CURRENT TIMESTAMP COMMENT ' 
操作 时 间 '， 
PRIMARY KEY (“id) 
) ENGINE=MyYyISAM DEFAULT CHARSET=utf8 COMMENT=" 
预约 信息 表 '; 
































































































































2. 流 程 设计 


当 用 户 点 击 “ 预 约 ” 菜 单项 时 ， 需 要 分 两 种 情况 处 理 : 


“ 如 果 用 户 近期 未 预约 ， 可 能 用 户 想 通过 公众 平台 预约 一 下 座位 ， 这 时 应 返回 预约 页 面 。 


“ 如 果 用 户 近 期 已 提交 预约 ， 可 能 用 户 点 击 只 为 查看 一 下 预约 信息 ， 这 时 应 返还 用 户 的 预约 信息 。 


流程 图 如 图 7-12 所 示 。 


点 击 预约 菜单 








香 看 数据 库 省 
无 预约 信息 










显示 我 的 预约 页面 显示 预约 页 面 





图 7-12 
菜单 项 “预约 ”是 一 个 click 类 型 ， 点 击 时 微 信服 务 器 会 进行 事件 推送 ， 我 们 设 定 的 key 是 CLICK_RESERVE， 代 码 如 下 : 


"type"™ “ mw click" 
"name™ 。 mw 
预 丝 TY 

"key": "CLICK RESERVE" 





























在 defaultweixin.php 文 件 中 ， 我 们 先 捕获 事件 推送 消息 中 的 菜单 点 击 事 件 ， 再 通过 key 值 筛选 出 CLICK_RESERVE， 对 此 处 进行 预约 管理 ， 具 体 代 码 如 下 : 

















// 
判断 并 处 理事 件 推送 























else if (Sthis->isEventMsd()) { 
Switch ($data->Event) 1 
// 
省 略 


Case 'CLICK': 
$sthis->click ($data);// 





处 理 菜 单 点 击 事件 
break; 

// 

省 略 





private function click($data) { 
SeventKey = $data->EventKey; 
Switch ($eventKey) 1 


Case 'CLICK RESERVE':// 
处 理 预 约 管理 


























$sthis->goreserve ($data); 
break; 


我 们 在 goreserve 这 个 方法 里 处 理 预约 管理 ， 请 参看 defaultweixin.php 文 件 中 的 goreserve 方 法 (Line: 132) 。 


首先 从 数据 库 里 读 出 当前 用 户 的 最 近 预 约 信息 。 如 果 有 该 用 户 的 预约 信息 ， 并 且 判 断 dinertime 的 值 大 于 当前 时 间 (为 了 应 对 客人 因 特 殊 原因 而 迟到 的 情况 ， 预 留 了 30 分 钟 组 站 时 间 ) ,说明 还 没 过 
期 ， 预 约 有 效 ， 这 时 应 该 返回 该 用 户 的 预约 信息 。 如 果 数 据 库 中 没有 该 用 户 的 预约 信息 ， 或 预约 已 过 期 ， 就 应 该 返回 预约 页 面 供 用 户 预约 。 


3. 网 页 与 样式 


“餐厅 管家 ”有 很 多 网 页 ， 为 此 我 们 将 样式 和 公共 部 分 提取 出 来 。 样 式 部 分 占 篇 幅 较 大 ， 请 参看 随 书 代码 (可 在 华章 网 站 下 载 ) 。 


公共 头 部 header.php 的 完整 代码 如 下 : 





<!DOCTYPE HTML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 

<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 

<title><?php echo $title;?> 

倪 子 饭庄 </title> 

<link type="text/css" rel="stylesheet" href="public/diner.css" /> 

</head> 

<?php 

include once 'model/SaeDB.class.php'; 

?> 







































































这 里 我 们 预 留 了 一 个 $title 变量 ， 用 来 表示 页 面 的 标题 。 并 且 引 入 SaeDB.class.php， 以 便 其 他 文件 能 使 用 MySQL 服 务 。 


4. 预 约 页 面 


预约 页 面 如 图 7-3 所 示 。 


其 中 包含 电话 一 栏 ， 这 里 用 到 了 HTML 5 的 tel 字 段 ， 这 里 介 


HTML 5 标准 增加 了 多 个 新 类 型 的 表单 ，tel 就 是 其 中 之 一 


手机 : <input type="tel" name="mobile" /> 


te 字段 与 普通 的 text 并 无 明显 区 别 。 在 HTML 5 标准 中 ，tel| 类 
定 用 于 验证 输入 字段 的 模式 。 例 如 : 


手机 : <input type="tel" name="mobile" pattern="\d{3} 


绍 一 


。tel 输 入 类 型 用 于 应 该 包含 电话 号 码 的 输入 字段 。 例 如 


型 除了 去 掉 换 行 符 之 外 ， 并 不 会 校 验 和 过 滤 用 户 输入 的 数据 。 如 果 要 实现 输入 字段 的 验证 ， 


-\d{4}-\d{4}"/> 


正则 表达 式 "\d{3}-\d{ 人 D-\d{4}" 规 定 了 用 户 输入 的 手机 号 码 必 须 是 188-8888-8888 类 似 的 格式 。 


tel 的 另 一 个 用 法 是 拨打 电话 。 


<a href="tel:18888888888> 
拨打 18888888888</a> 













































































在 手机 上 上 点击， 就 可 以 打开 拨号 界面 ， 并 可 以 直接 拨打 上 述 的 号 码 。 
<?php 

$title = " 

预约 座位 '; 

include ae ld 

$mysql = SaeDB::getInstance();// 

获取 MySQL 

实例 

$openid = $mysql->escape($ GET['user']);// 

获取 当前 用 户 的 openid 

$sql = "SELECT ‘id’, fname FROM ‘diner Locs ”LIMIT 10";// 
查询 分 店 

$data = $mysql->getData( $sql );// 

获取 数据 

$mysql->closeDb();// 

关闭 数据 库 连接 

2> 


<body class="bc f9"> 
<div class="wrap gp box"> 
<h1> 加 
填写 预约 信息 ， 我 们 会 为 你 预 留 座位 </n1> 
<div class="ap fm box"> 
<div class="r btn | box"> 
<a class="r arr bt 

















各 
































</div> 


tn phone ico" href="tel: 
<span class="r arr"><a href="tel:400- 


400-400-1234"><span class="num">400-400-1234</span></a> 
400-1234"><em></em></a></span> 











<form id="post 


form" method="post" action 





"savereserve.php" onsubmit="return check();"> 


<input type="hidden" name="openid" value="<?php echo S$openid;?>"/> 





<div class="name box cf"> 
<input placeholder=" 
请 输入 姓名 " id="username" name="name" type="text" /> 
































<input type="hidden" name="sex" id="sex" value="1" /> 
<p><span class="on" id="sex male"> 















































先生 </span><span id="sex female"> 
女士 </span></p> 
</div> 
<div class="phone box"> 
<input type="text" placeholder=" 
人 数 " id="num" name="num"/> 
</div> 
<div class="date box"> 
<input type="date" id="dinerdate" placeholder=" 
日 期 " name="dinerdate" class="date"/> 
<input type="time" id="dinertime" placeholder=" 
时 间 " name="dinertime" class="time"/> 
</div> 
<div class="phone box"> 
<input type="text" placeholder=" 
手机 " id="phone" name="phone" value=""/> 
</div> 
<div class="select" > 
<select name="locid"> 
<option value="" disabled selected> 
选择 分 店 </option> 
<?php 
foreach ($data as Sitem) { 
echo "<option value="'{$item['id'] }'>{$item['fname'] }</option>"; 


} 
?> 
</select> 
</div> 
<div S/diy> 
<div class="ap bot box"> 
<p> 加 加 


次 迎 你 在 旬 了 饭庄 预约 座位 ， 为 了 更 好 服务 于 你 ， 请 





填写 真实 信息 。 




















如 果 你 不 能 按时 到 达 本 店 ， 我 们 会 联系 你 并 将 预约 时 间 延 长 30 
分 钟 ， 之 后 将 不 再 预 留 座位 。</p> 

</div> 

<div class="ap btn box"> 

<a href="javascript: 

预 
约 </a> 

</div> 

</form> 
</div> 
</div> 

</body> 


<script type="text/javascript"> 
function check() { 




































































</p> 


;" onclick="check();"> 





Var username = document .getElementById ("username") .value; 
Var num = document .getElementById ("num") .value; 

Var dinerdate = document .getElementByld ("dinerdate") .value; 
Var dinertime = document .getElementByld ("dinertime") .value; 
Var phone = document .getElementByld ("phone") .value; 























if(!Iusername)!{ 








alert('" 
姓名 不 能 为 空 ') 
es re false; 
} 
if (lnum){ 
alert('" 
人 数 不 能 为 空 ') 
ee false; 





需要 使 用 input 的 pattern 属 性 。pattern 属 性 规 


Co 








if(!dinerdate)t{ 
alert(" 
日 期 不 能 为 空 '); 
return false; 


} 


if(!dinertime)t{ 
































































































































alert(" 
时 间 不 能 为 空 '); 
return false; 
} 
if(!phone) { 
alert(" 
电话 不 能 为 空 ') ; 
return false; 
} 
document .getElementById ("post form") .submit (); 
} 
</script> 
<script type="text/javascript" charset="utf-8" src="ht 
<script type="text/javascript" src="public/da 
<link rel="stylesheet" type="text/css" href="public/da 
<script type="text/javascript" src="public/datepicker/bootstrap-da 
<link rel="stylesheet" type="text/css" href="public/datepicker/boo 
<script type="text/javascript"> 
// 
选择 时 间 
S('"#qinertime') .timepicker ({ 
'showDuration': true, 
'timeFormat': 'H:i" 
}); 
// 
选择 日 期 



























































$ ('#dinerdate') .datepicker ({ 





format ' : 
"autoclose ' : 


} 





'mm/dd/yyyy", 
true 


$ (document) .ready (function() { 


// 
切换 性 别 











$ ("#sex male") .C] 


ick (1 


function(){ 


$('#sex male') .addClass ('on'); 












































$('#sex female') .removeClass ('on'); 
Ss('#aex') ,val (1): 
| 
// 
切换 性 别 
$("#sex female") .click (function(){ 
$('#sex female') .addClass ('on'); 
$('#sex male') .removeClass ('on'); 
$s ('#sex') .val (2); 
D3 
3 
</script> 
</html> 











tp://lib.sinaapp.com/js/jquery/1.9.0/jquery.min.js"></script> 
tepicker/jquery.timepicker.min.js"></script> 
tepicker/jquery.timepicker.css" /> 
tepicker.js"></script> 
tstrap-datepicker.css" /> 


在 代码 中 ， 需 要 填写 用 户 的 预约 日 期 和 时 间 ， 但 遗憾 的 是 ， 微 信 内 置 浏览 器 并 不 支持 date 和 time 字 段 ， 所 以 使 用 了 开源 的 日 期 和 时 间 选 择 控件 。 


https://github.com/jonthornton/jquery-timepicker, 


当 用 户 填 完 信息 提交 时 ，check 函 数 会 检查 参数 是 否 已 经 填写 。 如 果 检 验 通过 


File: diner/savereserve.php 的 完整 代码 如 下 : 


<?php 





include once 'model/SaeDI 











B.class.php'; 


Smysal = SaeDB: :getInstance () ， 





Sname = 
Ssex = 








$mysql->escape ($ POST['name']); 
intval($ POST['sex']); 


Snum = intval ($ POST['num']); 


$sdinerdate = 
$sdinertime = 





$mysql->escape ($ POST['dinerdate']); 
$mysql->escape ($ POST['dinertime']); 


$openid = $mysql->escape($ POST['openid"']); 


sphone = 
$locid = intval 




















$sql = "INSERT 
smysql->runSqgl] ($sql) 
if (Smysql->errno() 

















一 





die ("Error:" 
} 
smysql->closeDb (); 


$mysql->escape ($ POST['phone']); 
($ POST['locid']); 
$dinertimestamp = strtotime ($dinerdate.' 





NIO ‘diner reserve 


r 


!= 0) 


(人 


. Smysql->errmsg ()); 


‘name , 


header ("Location:myreserve.php?user={$openid}"); 





5. 我 的 预约 页 面 


我 的 预约 页 面 如 图 7-4 所 示 。 


File: diner/myreserve.php 的 完整 代码 如 下 : 


<?php 
$title = " 
我 的 预约 '; 


include 'header .php' 








六 


Smysal = SaeDB: :getInstance () ， 
$openid = $mysql->escape($ GET['user']); 



























































'.Sdinertime); 


sex, 


‘num', dinertime ’, openid’, phone ’, locid, 


'{$openid}' order by dinertime desc"; 





$sql = "SELECT * 

FROM ‘diner reservVe 

WHERE “openidq” LIKE 

$data = $mysql->getLine( $sql );// 
获取 我 的 预约 信息 

$sql = "SELECT * FROM 





$loc = $mysql->getLine( $sqgl );// 





获取 预约 分 店 的 信息 
?> 


<body> 


<div class="desc text"> 


<p> 


预约 人 : <?php echo S$Sdatal'name'].' ';i 


a 


先生 ';}else{echo ' 
女士 ';}?></p> 
<p> 








人 数 : <?php echo S$data['num'];?></p> 


<p> 



































1d 


<p> 

















话 ; 














<p> 


分 店 : <?php echo S$loc[' 





<p> 








OC 





地 址 : <?php echo $loc['] 


< 





] 餐 时 间 : <?php echo date ("m 
日 H:i", $data[l'dinertime']);?></p> 
<?php echo $data[l'phone'];?></p> 


fname'];?></p> 


he 











p> 
如 果 你 有 任何 意见 或 建议 ， 欢 迎 来 电 </p> 

















， 就 提交 给 savereserve.php 处 理 。 





‘diner locs ”where id = {$datal[l'locid']} LIM 


f($data[l'sex']==1) {echo ' 


下 Ys 





“addtime  ) VALU] 


ES 
F 
FE 


(NULL, 


项 目地 址 为 : 


'{Sname}', 


{Ssex}, 


{$num}, 


{Sdinertimestamp},"'{S$c 


<p> 
兔子 饭庄 服务 电话 : <span class="num">400-400-1234</span></p> 
</diyvy> 
</body> 
</html> 





7.2.5 ”菜单 管理 


当 用 户 点 击 “ 点 菜 ” 菜 单项 时 ,会 直接 打开 一 个 网 页 。“ 点 菜 ” 菜 单项 的 配置 如 下 : 





"type": myiew" 
name"™: " " 
点 菜 " 
Jy r 


wurl": "http://url.cn/NLGyKA" 


1. 数 据 表 设 计 


菜单 的 结构 如 表 7-3 所 示 。 


字 段 名 字段 类 型 


5 








name varchar 
imeurl varchar 
category tinyint 
addtime timestamp 


available 字 段 表 示 是 否 上 架 。 对 餐饮 业 来 说 ， 某 些 时 鲜 类 菜品 在 某 些 季 节 稀缺 ， 所 以 用 这 个 字段 表示 菜品 是 否 可 供 客人 点 菜 


创建 菜单 表 的 代码 如 下 : 


主键 标识 ， 目 增 
图 片 地 址 

价格 

菜肴 的 分 类 

是 否 上 加 
操作 时 间 


。 展 示 荣 单 时 ， 也 只 显示 上 架 的 菜品 。 





表 的 结构 “diner menu 








CREATE TABLE IF NOT EXISTS ‘diner menu ( 





















































“id int(10) NOT NULL AUTO NCREMENT COMMENT ' 
主键 '， 
“name ” varchar (100) NOT NULL COMMENT ' 








imgurl varchar (200) NOT NULL COMMENT ' 
『 
六 
“Price” float NOT NULL COMMENT ' 
价格 '， 
‘category tinyint (4) NOT NULL DEFAULT '0' COMMENT '1 
精美 小 荣 ,， 2 














六 
一 








available tinyint(1) NOT NULL DEFAULT "0 COMMENT ' 





























上 架 ，1 
下 架 '， 

“adqdtime ”timestamp NOT NULL DEFAULT CURRENT TIMESTAMP COMMENT , 
操作 时 间 '"， 


PRIMARY KEY ( id) 
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT=" 


















































2. 菜 单 展示 页 面 
当 用 户 点 菜 时 ， 给 用 户 返 回 菜单 展示 页 面 ， 如 图 7-5 所 示 。 
默认 给 用 户 展 示 所 有 种 类 的 菜肴 。 当 用 户 点 右上 角 的 “更 多 ”按钮 并 选择 某 种 类 菜肴 的 时 候 ， 只 展示 该 种 类 的 菜肴。 


File: diner/menu.php 的 完整 代码 如 下 : 





点 菜 '; 

include '‘'header.php'; 

$category = intval ($ GET['cat']); 

Smysal = SaeDB: :getInstance () ， 

if ($category) {// 

如 果 带 有 有 效 的 cat 

参数 ， 则 获取 该 种 类 的 菜肴 清单 
$sql = "SELECT * FROM ‘diner menu where category = {$category} and available = 0 LIMIT 10"; 


}else{// 
如 果 没 有 有 效 的 cat 
参数 ， 则 默认 返回 全 部 种 类 菜肴 



















































































"SET 








$sql = ECT 





} 


* FROM 









































































































































$data = $mysql->getData( $sql ); 
smysql->closeDb (); 
?> 
<SCTipt> 
当 页 面向 下 滑动 时 保持 顶部 导航 条 固定 不 变 
window.onscroll = function() { 
Var wint = document .documentElement .scrollTop; 
if (wint === 0) wint = document .body.scrollTop; 
var omng = document .getElementByld ("menu nav"); 
Var head = document .getElementById ("header"); 
if (omng) { 
if (omng.offsetTop < wint -5) omng.style.position = " 
else omng.style.position = "Static'， 
} 
} 
// 
切换 显示 
function toggle(o, id, m, 1) { 
= document .getElementById (iqd); 
if (c.style.display == 'none') 1 
c.style.display = "''; 
} else { 
c.style.display = 'none'; 
} 
return false; 
} 
</script> 


<body class="bc f9"> 
<div class="topbar"> 
<div class="menu nav"> 





<a hre 
首页 </a><a href="#"T> 





客户 端 </a> 


f="'#"> 








<a class="more" hre 


</div> 


<div id="popnav" class="popnav" > 


<div cl 
<ul> 
< 





菜品 </a></1i> 


1i><a href="menu.php?cat 





ass="menu cat"> 








和 哺 美 小 菜 </a></1i> 


i><a href="menu.php?cat= 





炒菜 </a></1i> 
本 








i><a href="menu.php?cat 





汤 姜 </a></1i> 





‘diner menu where available = 





1i class="pops"><a href="#"> 


二 "> 


20> 


=3"> 


i class="pops"><a href="#"> 


1i><a href="menu.php?cat= 








1i><a href="menu.php?cat 





1i><a href="menu.php?cat 





主食 </a></1i> 和 
面 点 </a></1i> _ 
炒饭 </a></1i> 
盖 饭 </a></1Li> 

















水 </a></1i> 


一 < 











一 ] 


J]i class="pops"><a href 


i><a href="menu.php?cat= 





饮料 </a></1i> 
区 














啤酒 </a></1i> 














i><a href="menu.php?cat 








i><a href="menu.php?cat 

















ass="noborder"> 


< 
果 汗 </a></1i> 
</ul> 
</div> 
</div> 
</div> 
<div class="menulist"> 
< 外] 
<?php 
i 








} 


foreach 





<span cl 
<span cil 


元 </span> 


f (empty (sdata) ) { 

echo 
没有 此 类 美食 ， 点 些 其 他 美食 吧 ^ ^; 
(Sqata as Sitem) {?> 


<li><dLiy Cl 
<a hre 


ass="menu item"> 





4"> 
=5"> 
=6"> 
="#"> 
7"> 
=8"> 


=9"> 


f="#"><img src="<?php echo $item['imgurl'] 














</a></div> 


</11i> 
<?php } ?> 
</Ul> 
</body> 
</html> 


3. 菜 单 管理 后 人 台 


除了 给 用 户 展示 菜单 外 ， 


需要 一 个 管理 后 


此 部 分 相关 的 文件 为 : 


* diner/addmenu.php: 


添加 菜单 


.dinet/saveaddmenu.php: 保存 添加 的 菜单 


dinet/myreserve.php: 修改 菜单 


.dinet/saveeditmenu.php: 保存 修改 的 菜单 


“ diner/menulist.php: 


“ diner/delmenu.php: 


7.2.6 


“物美 价 廉 ” 是 大 多 


浏览 菜 单 


删除 菜单 


二 维 码 优惠 券 


数 顾客 购物 消费 的 标准 之 一 


样 的 行业 环境 下 ， 以 优惠 为 卖点 的 团购 依然 火爆 。 


在 移动 互联 网 时 代 ， 
不 会 丢失 。 而 且 ， 


过 发 传单 来 促销 有 点 过 时 。 
愿意 掏 出 手机 来 扫 二 维 码 的 ， 大 多 是 


台 供 工作 人 员 


。 如 果 一 个 商品 质 





0 LIM 








于 LO 








fixed';} 


ass="menu item desc"><?php echo $item['name'];?></span> 
ass="menu item desc"><?php echo $item['price'];?> 





如 果 用 户 对 店家 印象 不 错 ， 那 迟 





AN 





添加 、 修 改 、 浏 览 和 删除 菜单 。 由 于 此 部 分 仅 沙 


) 炙 


质量 不 错 ， 磁 巧 还 有 优惠 ， 而 且 顾 客 刚好 需要 ， 那 么 


多 数 人 接 传 单 是 出 于 礼 狐 ， 然 后 会 丢 在 最 近 的 垃圾 箱 里 。 
潜在 顾客 。 


B34 





步 及 数据 表 的 增删 读 写 ， 而 与 微 


就 离 成 交 不 远 了 。 








;?>" width="150" height="150" border="0" alt="<?php echo $item['name'] 


言 公众 


餐饮 行 


;2>" /> 


平台 开发 无 天 。 因 此 请 在 随 书 代码 中 查看 ， 书 中 不 下 痪 


业 尤 其 如 此 。 竞 争 激 


列 ! 


AAMT 


这 样 的 促销 效果 让 人 堪忧 。 如 果 采 用 二 维 码 优 惠 券 ， 用 户 只 需 


f="javascript:"><img src="http://devweixin-devweixin.stor.sinaapp.com/menu/more menu.jpg" width="43" height="32" border="0" onclick="toggle (this, 


扫 一 扫 就 可 领取 ， 存 放 多 


We 


顾客 口味 越 来 越 挑 吻 ， 即 便 在 这 


微 信 提供 了 用 于 推广 支持 的 二 维 码 接口 ， 我 们 可 以 用 来 生成 二 维 码 优惠 券 ， 并 在 促销 活动 中 使 用 。 


1 数据 库 设计 


我 们 需要 二 维 码 优惠 券 表 来 保存 二 维 码 信息 ， 表 的 结构 见 表 7-4: 


表 7-4 
字 段 名 字段 类 型 字段 描述 


Id E 键 标识 ， 自 增 
discount 折扣 

qrcode - 维 码 优惠 券 图 片 地 址 
used varchar 使 用 情况 


一 般 的 优惠 券 需 要 设置 不 同 的 优惠 折扣 和 校 验 码 等 ， 用 于 消费 时 验证 二 维 码 的 真 仿 。 同 时 有 些 商 家 不 希望 在 节假日 或 周末 使 用 优惠 券 ， 所 以 used 字 段 有 三 个 值 : 0 代表 未 使 用 ，1 代 表 已 使 用 ，2 代 表 茶 
止 使 用 。 


创建 二 维 码 优惠 券 表 的 代码 如 下 : 





表 的 结构 “diner arcodqe 

































































CREATE TABLE IE NOT EXISTS ‘diner grcode  ( 
“id int(10) NOT NULL AUTO _ NCREMENT COMMENT ' 
主键 '， 
‘discount. float NOT NULL COMMENT ' 
折扣 "'， 
‘sceneid int(10) NOT NULL COMMENT ' 
校 验 码 '， 








`arcoqe ”varchar (200) DEFAULT NULL COMMENT ' 
二 维 人 码 优惠 券 图 片 地 址 '， 
‘used’ varchar(1) DEFAULT '0' COMMENT ' 




































































是 否 被 使 用 ，0 
代表 未 使 用 ，1 
代表 已 使 用 ，2 
代表 禁止 使 用 '， 











“adgdtime. timestamp NOT NULL DEFAULT CURRENT TIMESTAMP COMMENT ' 
操作 时 间 '， 

PRIMARY KEY (“id.) 
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT=' 
二 维 码 优惠 券 表 ' ; 







































































2. 生 成 二 维 码 优惠 券 


目前 微 信 提 供 2 种 类 型 的 二 维 码 ， 分 别 是 临时 二 维 码 和 永久 二 维 码 ， 前 者 有 过 期 时 间 ， 最 大 为 1800 秒 ， 但 能 够 生成 较 多 数量 ; 后 者 无 过 期 时 间 ， 数 量 较 少 (目前 参数 只 支持 1 到 10 万 ) 。 和 餐饮 行业 的 优惠 
券 有 效 期 比较 长 ， 因 此 永久 二 维 码 比较 适用 。 但 永久 二 维 码 数量 较 少 ， 而 且 用 于 优惠 券 的 数字 要 尽量 随机 ， 所 以 我 们 选择 10000 到 99999 之 间 的 5 位 随机 数 作为 校 验 码 。 


生成 指定 范围 内 的 随机 数 的 公式 为 : 





Math.random()* (n-m) +m 





添加 二 维 码 优惠 券 的 页 面 如 图 7-13 所 示 : 


( 上 车 生成 二 维 码 优惠 券 、 免 子 饭庄 


面额 ( 申 位 : 元) 
Dc 
验证 码 〈《 用 于 顾客 使 用 时 校 验 真 伪 ) 


48669 
随机 生成 


皖 交 





图 7-13 
点 击 随机 生成 ， 验 证 码 表单 会 填 上 随机 生成 的 5 位 数 。 


File: diner/addqr.php 的 完整 代码 如 下 : 





<?php 
$title = " 
生成 二 维 码 优 惠 券 '; 
include 'header.php'; 
?> 
<body> 
<?php 
if(lisset($ GET['msg']) && $ GET['msg'] == "emptyparams'){ 
echo '<p class="error"> 
面额 和 验证 码 不 能 为 空 </p>' 7; 
2> 
<form action="saveaddgr.php" method="post" onsubmit="return check();"> 
<label for="discount"> 
面额 (单位 : 元 ) </label> 
<input type="text" name="discount" id="discount"/> 
<label for="sceneid"> 
验证 码 《〈 用 于 顾客 使 用 时 校 验 真 伪 ) </label> 
<input type="text" idq="sceneidq" name="sceneid"/> 
<button onclick="getrandomid();return false;"> 
随机 生成 </button> 
<input type="submit"/> 
</form> 
</body> 
<script type="text/javascript"> 
// 
生成 10000 
到 99999 
之 间 的 随机 数 
function getrandqomiad() { 
var randomid = Math.round (Math.random()* (99999-10000))+10000; 
document .getElementById('sceneid') .value = randomig; 








































































































function check(){ 
Var discount = document .getElementById("discount") .value; 
Var sceneid = document .getElementByld("sceneid") .value; 
if(!discount)f{ 
alert (" 
面额 不 能 为 空 ')，; 
return false; 
































Se 








片 - ~ 一 


f(!sceneid)t{ 
alert(" 
验证 码 不 能 为 空 ')，; 


return false; 
} 


return true; 





} 
</script> 
</html> 


如 果 表 单 校 验 通 过 ， 会 提交 到 saveaddqr.php。saveaddqr.php 需 要 完成 以 下 操作 : 
1) 将 校 验 码 作为 场景 值 ID， 调 用 微 信 二 维 码 接口 生成 二 维 码 图 片 。 
2) 将 二 维 码 图 片 存 放 到 自己 的 服务 器 上 。 


3) 将 数据 写 入 数据 库 中 。 


saveaddqr.php 的 完整 代码 如 下 : 





File: diner/saveaddqr .php 








<?php 
$discount = isset($ POST['discount'])? floatval($ POST['discount']):0; 
$sceneid = isset($ POST['sceneid'])?intval($ POST['sceneid']):1; 





require "lib/weixin.class.php"; 

Sticket = weixin::getQrcodeTicket ($sceneiqd,0);// 
生成 二 维 码 ticket 
$imgbin = weixin: :getQrcodeImgByTicket ($ticket);// 
用 ticket 
去 换 二 维 码 图 片 


// 
以 下 代码 将 图 片 保存 到 SaeStorage 
$storage = new SaeStorage (); 
$sdomain = 'devweixin'; 
$sdestFileName = md5 (time()).'.jpg'; 
Sattr = array('encoding'=>'gzip'); 
$imgurl = $storage->write ($domain,S$destFileName, S$imgbin, -1, S$attr, true); 
if (lSimgurl){ 
exit ('error'); 





























上 


} 
include once 'model/SaeDB.class.php'; 
smysql = SaeDB: :getInstance () ， 
if(!$discount || !$sceneidqd){ 
header ("Location:addgr.php?msg=emptyparams"); 

















} 





























$sql = "INSERT INTO ‘diner aqrcoqe ” (‘id’, ‘discount ， ‘sceneid’, qrcode’) VALUES (NULL, '{S$discount}', '{$sceneid}','{$imgurl}');"; 
$mysql->runSql ($sql); 
if ($mysql->errno() != 0) 
{ 
die ("Error:" . $mysql->errmsg ()); 





} 

smysql->closeDb (); 

?> 

<body> 

<div class="gqrcontainer"> 


<p> 
你 的 优惠 券 已 生成 。</p> 
<img class="grimg" src="<?php echo $imgurl;?>"/> 
<span><a href="qgqrlist.php"> 
返回 列表 </a></span> 
</div> 
</body> 
</html> 











这 里 用 到 了 SAE Storage 存 储 服务 。 如 果 在 其 他 平台 ， 可 以 用 fwrite 函 数 将 图 片 备份 到 自己 的 服务 器 上 ， 如 下 代码 所 示 : 





int fwrite ( resource Shandqle , string $string [, int $length ] ) 








3. 优 惠 券 列表 


优惠 券 列表 如 图 7-14 所 示 。 其 中 “查看 大 图 ”可 以 查看 大 图 预览 ， 方 便 用 户 扫 一 扫 。 为 了 使 优惠 券 列表 页 能 跨 终端 显示 ， “查看 大 图 ”功能 判断 用 户 所 用 的 终端 ， 如 果 在 微 信 上 浏览 ， 会 调用 微 信 J% 的 
图 片 预览 功能 。 如 果 在 其 他 浏览 器 上 ， 则 用 colorbpox 实 现 大 图 预览 。colorbox 是 一 个 开源 的 图 片 预 览 和 幻灯 择 件 ， 项 目地 址 为 : http://www.jacklmoore.com/colorbox/。 





图 7-14 


File: diner/qrlist.php 的 完整 代码 如 下 : 















































<?php 

$title = '" 

优惠 券 列表 '; 

include 'header.php'; 

Smysal = SaeDB: :getInstance () ， 

$sql = "SELECT * from ‘diner qrcode LIMIT 10"™; 
$data = $mysql->getDatal( $sql ); 





smysql->closeDb (); 








// 
使 用 SAE Channel 
服务 
schannelname = "qrcheck'; 
$channel = new SaeChannel () ; 
Sconnection = $channel->createChannel ($channelname, 600) ， 
?> 
<body> 

<?php if(empty ($data)){ 

echo ' 





你 还 未 添加 过 优惠 券 ，<a href="addqr .php"> 
点 此 添加 </a>'; 

}elsel 

?> 

<p><a href="addgr.php"> 





继续 添加 </a></p> 
<table class="gridtable" width="98%"> 
<tr> 
<th> 
面额 </th> 


校 验 码 </th> 


二 维 码 </th> 


<th> 


<th> 





<th> 





是 否 使 用 </th> 





<th> 





操作 </th> 
</tr> 
<?php 
foreach ($data as Sitem) { 
echo 1!<tr>1; 
echo "<tdq>{Sitem['dqiscount'] }</Ld>"， 
echo "<td>{$item['sceneid']}</tgd>"; 
echo "<td><img width="'30px' src="'{$item['grcode']}'/></tqd>"; 























if($item['used'])t 
echo "<td> 
是 </td>"; 
}elsef{ 
echo “<td> 
否 </tqd>"; 





} 
echo "<td><a href='javascrip:' onclick=\"preview('{S$item['grcode']}');\"> 
查看 大 图 </a> <a href='delgqr.php?igd={$item['id']}'> 
删除 </a></td>"; 
echo ‘<tr>'; 
































} 

?> 
</table> 
<?php } ?> 

</body> 
<script type="text/javascript"> 





全 局 变量 ， 用 于 标识 WeixinJSBridge 
是 否 完成 初始 化 ，0 














为 未 完成 ，1 

为 已 完 
winxinJsBridgeReady = 0; 
/7 


处 理 WeixinJSBridgeReady 






































































































































事件 ， 当 初始 化 完成 后 ， 将 winxinJsBridgeReady 
标记 为 1 
document .addEventListener ('WeixinJSBridgeReady', function onBridgeReady() { 
if (typeof WeixinJSBridge == "object" && typeof WeixinJSBridge.invoke == "function™") { 
winxinJsBridgeReady = 1; 
} 
}); 
/** 
大 
图 片 预览 
4 
function preview (imgurl) { 
//// 
判断 WeixinJSBridge 
是 否 完成 初始 化 ， 未 完成 直接 返回 false 
if (winxinJsBridgeReady === 0) {// 
如 果 不 在 微 信 中 ， 则 使 用 colorbox 
预览 图 片 














$.colorbox({href:imgurl}); 
return true; 


} 
// 
如 果 在 微 信 中 ， 调 用 微 信 的 图 片 预览 功能 


WeixinJSBridge.invoke ("imagePreview", { 
"ourrent": imgurl, 
"urls": [imgurl] 

},;function (res)t{ 
alert (res.err msg); 
































}); 
} 
</script> 
<script type="text/javascript" charset="utf-8" src="http://lib.sinaapp.com/js/jquery/1.9.0/jquery.min.js"></script> 
<script type="text/javascript" charset="utf-8" src="public/colorbox/jquery.colorbox-min.js"></script> 
<link rel="stylesheet" type="text/css" href="public/colorbox/colorbox.css"></head> 
<script src="http://channel.sinaapp.com/api.js"></script> 
<script> 
Var channel = { 





















































url:"<?php echo $connection;?>", 
onMessage:function (m) { 

Var data = JSON.parse (m.data); 
if (data.type === 'requse'){ 
if (confirm(" 
顾客 将 使 用 《"+data.sceneid+t" 
》 校 验 码 ， 是 否 人 允许? ") ) { 


















































$.post ("douseqr.php", {sceneid:data.sceneid,type:1}, function (result){ 
Var data = JSON.parse (result); 
if(data.ret === 'OK') { 
alert (" 























顾客 已 使 用 该 校 验 码 ") ; 











location.reload () ; 


地 


}elsel 





$.post ("dqousear .php", {sceneid:data.sceneid,type:0}, function (result) { 
Var data = JSON.parse (result); 
if(data.ret === 'OK') { 

alert (" 























顾客 未 使 用 该 校 验 码 ") ; 








}; 











// 
创建 WebSocket 
实例 
Var socket = new WebSocket (channel .ur1); 
socket .onmessage = channel .onMessage; 
</script> 
</html> 


4. 使 用 优惠 券 


当 用 户 在 饭店 消费 时 ， 可 以 使 用 二 维 码 优惠 券 ， 使 用 方法 : “ 扫 一 扫 ”。 扫 完 之 后 ， 出 现 优 惠 券 的 信息 ， 如 图 7-7 所 示 。 


点 击 “ 点 此 使 用 ”后 ， 系 统 会 先 查 询 该 二 维 码 是 否 存 在 。 如 果 存 在 ， 会 进一步 验证 是 否 已 被 使 用 。 如 果 没 被 使 用 ， 系 统 会 发 出 消息 通知 饭店 的 前 台 。 当 前 台 同 意 使 用 时 ， 优 惠 券 就 能 成 功 使 用 了 。 整 个 
流程 如 图 7-15 所 示 。 


失败 ， 返 回 、 成 功 ， 返回 
错误 信息 。 ， \、 提示 信息 


图 7-15 





File: dinen\showqr.php 的 完整 代码 如 下 : 





<?php 

$title = " 

使 用 二 维 码 优惠 券 '; 

include 'header.php'; 

smysql = SaeDB: :getInstance () ， 

$sceneid = intval($ GET['sceneid']); 

$sql = "SELECT * FROM ‘diner qrcode where sceneid = {$sceneid}"; 
$data = $mysql->getLine( $sql ); 

smysql->closeDb () ， 

// 












































使 用 SAE Channel 








服务 
schannelname = "qrcheck'; 
$channel = new SaeChannel () ; 
$connection = $channel->createChannel ($channelname, 600);，; 
?> 
<body> 
<div class="qrcontainer"> 
<p> 
你 的 优惠 券 </p> 
<p> 


面额 : <?php echo S$data['discount'];?></p> 
<img class="grimg" src="<?php echo $datal[l'qgrcode'];?>"/> 
<span><a onclLick="usedr (<?php echo S$datal'sceneid'];?>);return false;" href="useqdr.php"> 














点 此 使 用 </a></span> 
<span igd="tips"></span> 
</div> 








<script type="text/javascript" charset="utf-8" src="http://lib.sinaapp.com/js/jquery/1.9.0/jquery.min.js"></script> 
<script src="http://channel.sinaapp.com/api.js"></script> 














<script> 
issentrsp = false; 
istimeout = true; 





Var tips = $('#tips'); 
function useqgr (sceneid){ 
=setTimeout ("timeout ()",60000);// 














等 待 1 


分 钟 








S.post("usedr.php", {sceneid:sceneid},function (result) { 
Var data = JSON.parse (result); 
if(data.ret === 'OK') { 
issentrsp = true; 
tips.html ("<img src='public/images/loading plack.gif'/>"+data.msgt+" 




















}else ifl(data.ret === 'used' || data.ret === 'error')f{ 
tips.html ("<img src='public/images/error.gif'/>"+data.msg+" 





























istimeout = false; 





Var intcheck = setInterval ("check()",2000); 
function check() { 
f(issentrsp)t 
$.post ("douseqr.php", {type:2,sceneid:<?php echo $datal[l'sceneid'];?>},function (result) { 
Var data = JSON.parse (result); 
if(data.ret === 'OK') { 
tips.html ("<img src='public/images/ok.gif'/>"+data.msg+" 











PF- 



































clearIinterval (intcheck); 
istimeout = false; 
}else if(data.ret === 'notallowed')!{ 








tips.html ("<img src='public/images/error.gif'/>"+data.msg+" 





clearIinterval (intcheck); 
istimeout = false; 











} 
} 





























function timeout (){ 
if (istimeout true)t{ 
clearIinterval (Intcheck) ， 
tips.htmll" 











你 使 用 优惠 券 的 请 求 未 得 到 回应 ， 请 联系 前 台 询 问 …") 
} 

} 

</script> 


</body> 
</html> 


文件 dine/useqr.php 负 责 上 发送 使 用 优惠 券 的 请 求 ， 如 果 优 惠 券 不 存在 或 已 被 使 用 ， 则 直接 返回 错误 信息 。 如 果 优 惠 券 有 效 ， 则 将 请 求 帮 送 给 前 台 。 完 整 代码 如 下 : 


<?php 
include once 'model/SaeDB.class.php'; 
$sceneid = JE 






































Smysaql = SaeDB: :getInstance () ， 
$sql = "SELECT * FROM ‘diner qrcode where sceneid = {$sceneid} and used = '0'™"; 
$data = $mysql->getLine( $sql] ); 


smysql->closeDb () ， 
if (empty ($data)){ 
echo json 人 ret'=>'used', 'msg'=>) 

















优惠 券 已 被 使 用 或 不 存在 ') 
exit (); 
} 
Schannelname = 'grcheck'; 
$schannel = new SaeChannel () ， 
$channel->createChannel ($channelname, 600) ， 





$message content = json encode (array('type'=>'requse','sceneid'=>$sceneid)); 
// Send message 
$ret = $channel->sendMessage ($channelname, $message content); 




















if ($ret)t 
echo json eT 
你 的 优惠 券 使 用 请 求 已 发 送 ') 
}elsef 
echo json 人 Let '=> "error' 'msg'=>" 




















(0 


文件 diner/douseqr.php 负 责 从 数据 库 中 取出 二 维 码 优惠 券 的 使 用 情况 ， 完 整 代码 如 下 : 


<?php 

include once 'model/SaeDB.class.php'; 
$type = intval($ POST['type']); 
$sceneid = intval ($ POST['sceneid']); 
Smysal = SaeDB: :getInstance () ， 

if ($type == 0){// 


0 
= json encode (array ('ret'=>'ok', 'msg'=>'" 
优惠 闫 不 多 漠视 这 且 
$sql = "UPDATE ‘diner qrcode” SET ‘used’ = '2' WHERE ‘sceneid ={$sceneid};"; 
SmysaqlL->runSdql ( $sql ); 
}else if($type == 1){// 
允许 使 用 
$sql] = "UPDATE ‘diner qrcode ”SET ‘used. 
smysql->runsgql ( $sql ); 
if ($mysql->affectedRows() < 1){//if 


































































































'1' WHERE ‘sceneid. ={S$sceneid} and ‘used. = 0;"» 



































update fails,then insert one 























$ret = json encode (array('ret'=>'error', 'msg'=>" 
优惠 券 已 被 使 用 或 不 存在 ") ) 
}elsel 
$ret We encode (array ('ret'=>'ok', 'msg'=>'" 














优惠 券 使 用 成 功 ') 
} 


}jelse if($type == 2){// 

查询 是 否 被 使 
$sql = "SELECT used FROM ‘diner qrcode where sceneid = {$sceneid}"; 
$data = $mysql->getLine( $sql ); 

if(!empty ($data)){ 


































































































if($data['used'] == 0){ 
$ret = json . ee t'=>'error', 'msg'=>'" 
优惠 券 还 未 使 用 ') ); 
}else ifl($datal'used'] == 1)f{ 
$ret = json encode (array('ret'=>'ok', 'msg'=>" 
优惠 券 使 用 成 功 ' ) ) ; 
}else if(Sqata['usedq'] == 2)f{ 
$ret = json encode (array('ret'=>'notallowed', 'msg'=>" 
优惠 券 不 允许 被 使 用 ') ) ; 
} 
J 
0 = J encode (array ('ret'=>'error', 'msg'=>" 
优惠 券 不 存在 


} 
smysql->closeDb () ， 
echo sret; 


5. 利 用 WebSsocket 实 现 信息 推送 


读者 也 许 注意 到 了 ， 使 用 优惠 券 部 分 多 次 出 现 SaeChannel 和 Websocket， 这 是 为 了 实现 实时 消息 推送 而 采用 的 技术 方法 。 当 用 户 发 送 完 使 用 优惠 券 请 求 后 ， 一 直 在 等 待 服务 器 的 响应 。 因 为 使 用 优惠 
券 需要 得 到 饭店 前 台 人 员 的 人 工 确认 ， 所 以 等 待 时 间 可 能 会 很 长 。 如 果 采 用 AJAX 技 术 ， 需 要 不 停 地 轮 询 来 查看 是 否 已 得 到 工作 人 员 确 认 。 轮 询 方 法 的 最 大 问题 是 ， 当 页 面 以 固定 频率 向 服务 器 发 起 请 求 的 时 
候 ， 服 务 器 端的 数据 可 能 并 没有 更 新 ， 这 样 会 带 来 很 多 无 用 的 网 络 传输 ， 所 以 这 是 一 种 非常 低 效 的 方案 。 


Websocket 是 HTML 5 众多 新 特性 之 一 ， 被 称 为 “Web 上 的 TCP”。 通 过 在 浏览 器 和 服务 器 之 间 建 立 了 一 个 基于 TCP 连 接 的 双向 通道 的 方法 ， 实 现 了 长 连接 。WebSocket 设 计 的 初衷 就 是 要 取代 轮 询 技 
术 ， 满 足 实时 Web 应 用 的 需要 。 浏 览 器 通过 javasScript 向 服务 器 发 出 建立 Websocket 连 接 的 请 求 ， 连 接 建 立 以 后 ， 客 户 端 和 服务 器 端 就 可 以 通过 TCP 连 接 直接 人 交换 数据 。 因 为 Websocket 连 接 本 质 上 就 是 一 
个 TCP 连 接 ， 所 以 在 数据 传输 的 稳定 性 和 数据 传输 量 的 大 小 方面 ， 和 轮 询 技术 比较 ， 具 有 很 大 的 性 能 优势 。 


但 是 直接 使 用 WebSocket 并 不 是 一 件 容易 的 事 ， 因 为 首先 需要 构建 一 个 实现 了 WebSocket 标 准 的 服务 器 。 幸 运 的 是 SAE 提 供 的 实时 消息 推送 Channel 服 务 ， 就 是 满足 WebSocket 标 准 的 服务 。 使 用 
Channel， 可 以 方便 地 在 浏览 器 和 服务 器 之 间 建 立 长 连接 ， 从 而 进行 消息 推送 。 


图 7-16 为 Channel 服 务 的 大 致使 用 流程 。 


应 用 channel 服 务 尊 





1. 调用 create_channel 创 建 一 个 channel 


2. 返回 channel 的 ur| 





3. 将 channel 的 url 传 给 客户 销 
4. 使 用 该 ur 连接 上 channel 的 服务 器 





发 送 消息 给 客户 端 


发 送 消息 


http 回 调 通知 应 用 


图 7-16 站 
简单 地 说 ，Channel 服 务 的 使 用 分 为 两 个 部 分 : 服务 器 端 和 JS 端 。 服 务 器 端 创建 channel url，JS 端 通过 WebSocket 连 接 服务 器 端 创建 的 channel url， 这 样 一 条 长 连接 就 实现 了 。 


我 们 在 第 7 章 说 过 ， 微 信和 内 置 浏览 器 不 支持 WebSocket， 那 么 也 无 法 使 用 Channel 服 务 。 在 diner/showqr.php 文 件 中 ， 笔 者 采用 了 AJAX 轮 询 方法 。diner/qrlist.php 可 以 在 电脑 上 查看 ,使 用 到 了 
Channel 服 务 和 WebSocket。 读 者 对 比 两 种 技术 即 可 发 现 ，Channel 和 WebSocket 使 用 方便 ， 开 发 者 只 需 关注 业务 本 身 。 而 轮 询 技 术 要 处 理 定时 和 超时 操作 ， 实 现 复 杂 。 


在 使 用 优惠 券 的 例子 中 ， 用 户 在 微 信 中 打开 diner/showqr.php 页 面 ， 而 前 台 工 作 人 员 在 电脑 上 打开 diner/qrlist.php。WebSocket 是 实时 通信 ， 因 此 需要 两 个 页 面 都 处 于 打开 状态 。 
在 优惠 券 列表 页 中 ， 首 先 我 们 创建 了 名 称 为 “qrcheck” 的 Channel， 并 用 Js 连接 channel url， 从 而 建立 了 一 条 长 连接 。 


当 用 户 发 送 使 用 优惠 券 请 求 后 ， 页 面 处 于 等 待 状 态 ( 见 图 7-17) ， 实 际 上 每 隔 1 秒 向 服务 器 查询 一 下 优惠 券 使 用 情况 。 


您 的 优惠 券 
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图 7-17 


useqr.php 向 JS 端 发 送 一 段 类 似 于 {"type" : “requse"， "sceneid": 50247} 的 JSJON 字 符 串 ， 这 时 qrlist.php 页 面 会 收 到 信息 并 弹出 提示 ( 见 图 7-18) 。 


devweixin.sinaapp.com 上 的 网 页 显示 : 


客 将 使 用 《50247》 校 验 码 ,是否 多 许 ? 





如 果 工 作 人 员 人 允许 使 用 该 校 验 码 ， 点 击 确定 后 ， 用 户 就 会 收 到 回应 ( 见 图 7-19) 。 


您 的 优惠 券 








图 7-19 


如 果 当 前 是 节假日 ， 不 允许 使 用 优惠 券 ， 点 击 “ 取 消 ” 后 ， 用 户 收 到 的 回应 如 图 7-20 所 示 : 








和 估 惠 芝 不 允 评 被 使 用 





图 7-20 


当 用 户 的 请 求 迟 迟 得 不 到 响应 ， 将 触发 超时 操作 。 为 演示 起 见 ， 超 时 时 间 为 1 分 钟 。 出 现 超时 时 ， 用 户 会 得 到 如 图 7-21 所 示 的 提示 : 


您 的 优惠 芽 
面额 : 5 











尽 此 使 用 
您 使 用 优惠 营 的 请 求 未 得 到 回应 ， 请 联系 天 人 台词 
回 .…… 


图 7-21 


[1] 来 源 于 SAE 人 官网。 


7.2.7 ”路 线 导 肌 


路 线 导航 的 核心 问题 是 : 目的 地 、 当 前 位 置 、 路 径 选 择 算法 。 目 的 地 是 饭店 地 址 ， 考 虑 到 有 多 家 分 店 ， 默 认为 距离 用 户 最 近 的 分 店 地 址 ， 用 户 当前 位 置 可 以 通过 微 信 地 理 位 置信 息 服务 来 获得 ， 路 径 选 
择 算法 要 借助 于 地 图 服务 ， 这 里 选择 腾讯 地 图 API 来 实现 。 


1. 腾 讯 地 图 API 


腾讯 地 图 APl 是 由 腾讯 公司 提供 的 地 理 位 置 服务 接口 ， 应 用 程序 接口 用 JavaScript 语 言 编写 的 ， 它 能 够 帮助 读者 在 网 站 中 方便 地 搭建 基于 地 图 应 用 程序 。 腾 讯 地 图 开放 API 提 供 了 : 构建 地 图 的 基本 接 
口 、 本 地 搜索 接口 等 ， 读 者 可 以 根据 自己 的 需要 进行 选择 。 地 图 API 的 服务 不 需要 注册 ， 向 第 三 方 免费 提供 ， 任 何 非 盈利 性 网 站 均 可 使 用 。 


本 节 的 代码 中 用 到 了 Javascript API V2 接口 。 它 可 用 于 在 网 站 中 加 入 交互 性 强 的 街景 、 地 图 ， 能 很 好 地 支持 PC 及 手机 设备 ， 身 材 小 巧 ， 动 画 效果 顺 滑 流 畅 ， 动 感 十 足 ， 提 供 地 图 操作 、 标 注 、 地 点 搜 
索 、 出 行规 划 、 地 址 解析 、 街 景 等 接口 ， 功 能 丰富 ， 并 免费 开放 各 种 附加 工具 库 。JavaScript API V2 是 免费 服务 ， 任 何 提供 免费 访问 的 网 站 都 可 以 调用 .。 


之 所 以 使 用 腾讯 地 图 API 主 要 出 于 以 下 几 点 考虑 : 
. 只 要 接受 并 认可 腾讯 地 图 API 使 用 条 款 ， 无 须 注 册 便 可 使 用 。 
完全 免费 ， 没 有 单 日 调用 上 限 的 限制 。 


. 数据 覆盖 广 ， 包 含 全 国 范围 内 的 地 图 底 图 ，300 多 个 地 级 市 ，2000 个 多 县 /县 级 市 的 POI 搜 索 ; 200 多 个 城市 的 公交 换 乘 方案 检索 ; 300 多 个 城市 的 驾车 方案 检索 。 
2. 数 据 库 设 计 


这 里 会 用 到 两 个 数据 表 ， 其 一 为 饭店 地 理 位 置信 息 表 ， 用 来 存储 各 分 店 在 地 图 上 的 位 置 ;其 二 为 用 户 地 理 位 置信 息 表 ， 用 来 存储 用 户 的 当前 位 置 。 


饭店 地 理 位 置信 息 表 的 结构 见 表 7-5: 


表 75 
字 上 段 名 字段 类 型 字段 描述 
rd | 主键 标识 ， 自 增 
fname 分 店名 称 
addtime 操作 时 间 


饭店 地 理 位 置信 息 表 的 创建 代码 如 下 : 





表 的 结构 “diner locs、 








CREATE TABLE IF NOT EXISTS ‘diner locs (人 
“id int(10) NOT NULL AUTO INCREMENT COMMENT ' 
主键 '， 


fname ”Varchar (100) NOT NULL COMMENT ' 
分 店名 称 '， 
‘Joc varchar(200) NOT NULL COMMENT ' 
地 址 '， 
Latitude float NOT NULL COMMENT ' 
纬度 r 
‘Longitude float NOT NULL COMMENT ' 
经 度 ' rr 
“adqdtime ”timestamp NOT NULL DEFAULT CURRENT T MESTAMP COMMENT ' 
操作 时 间 '"， 
PRIMARY KEY (id) 



































































































































) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT=" 
饭店 位 置信 息 表 ' ; 
































用 户 地 理 位 置信 息 表 的 结构 见 表 7-6: 


表 7-6 
字 段 名 字段 类 型 字段 描述 
Id EN 主键 标识 ， 自 增 
i 亚 
ne 到 
FromUserName 用 户 openid 
Reali 操作 


用 户 地 理 位 置信 息 表 的 创建 代码 如 下 : 


表 的 结构 “dinner userlocs、 








CREATE TABLE IF NOT EXISTS ‘dinner userlocs ( 




























































































“id int(10) NOT NULL AUTO INCREMENT COMMENT ' 
主键 '， 加 

“Latitudqe float NOT NULL COMMENT ' 
纬度 '， 

‘Longitude float NOT NULL COMMENT ' 
经 度 '， 

‘FromUserName varchar (100) NOT NULL COMMENT ' 
用 户 openiqd'， 

‘CreateTime int(10) NOT NULL COMMENT ' 











操作 时 间 '， 

PRIMARY KEY (‘id.) 
) ENGINE=MYyISAM DEFAULT CHARSET=utf8 COMMENT=" 
用 户 地 理 位 置信 息 表 ' ; 




































































3. 添 加 饭店 位 置 


对 饭店 工作 人 员 而 言 ， 需 要 在 地 图 上 标明 饭店 的 位 置 。 


文件 diner/addloc.php 的 完整 代码 如 下 : 





<?php 

$title = " 

添加 饭店 '; 

include 'header.php'; 

?> 

<script charset="utf-8" src="http://map.qq.com/api/js?v=2.exp"></script> 
aCript> 

Var map,markersArray = |[]; 








添加 标识 





var marker 


function addMarker (location) 
new qq.maps.Marker ({ 


position: location, 





map: map 


}); 


{ 


markersArray.push (marker); 


} 
4 
清除 标识 














1 








(i 


for 


function clearOverlays () 
(markersArray) 


{ 
{ 


in markersArray) 





{ 


markersArray[i].setMap (null); 





func 





var init = 





以 container 


为 地 图 


Im 

















zoom: 13 


}); 


// 
根据 客户 端 TP 
定位 地 图 中 心 位 置 
citylocation 
complete : 





























tion () 


容器 ， 在 网 页 中 创建 一 个 地 图 
ap = new qq.maps.Map (document .getE 
center: new qq.maps.LatLng (39.9] 


{ 





new qq.maps .Ci 
function (result 





~ 一 





{ 


和 

















ementBy 








tyService({ 


map.setCenter (result.detail.latLng); 


} 
}); 


citylocation.searchLocalCity(); 








/ 
上 的 点 下 


名 








为 地 事件 添 力 








Cl 





[监听 
qd.maps .event .adq] 





Var latLng 








Se 


a 


-ng, 








Lng .ge 











= la 

















ne 


ng .getl 


clearOverlays ();// 


清除 所 有 标识 





aqqMarker (latLng);// 


击 位 置 处 添加 标识 


Var geocoder 


在 点 














complete : 
当 完成 反 地 址 解析 后 ， 将 经 纬度 写 回 


loc 





| 








表单 字段 ， 将 地 址 写 
单字 段 




















documen 
documen 


} 
}); 





t () 

















t .ge 


emenl 


ByI 


Listener (map, 'click',function (event) 
= event .1atl 
La 
Lng () .1 


new dq.maps.Geocoder ({ 
function (result)t 
latLng 


("latLng") .valu 





{ 


.toFixed (5) ， 
toFixed (5); 


// 


eh: 1at 


Id("container"),{ 
6527,116.397128)， 




















t .ge 








emenl 





(a 





ByI 








loc") .value 





Td 


result 








geocoder .getAddress (latLng); 





}); 
} 


</script> 

</heagd> 

<body onloagd="init () "> 

<?php 

if(isset($ GET['msg']) && $ GI 








echo '< 


} 
?> 
<form ac 











Class="error"> 


饭店 名 称 和 饭店 位 置 不 能 大 


</p>'; 








abe 


< 
饭店 名 称 </] 


or 
abel> 








<inpu 


<label 
饭店 位 置 </] 


type= 























abel> 














Lext 
for="]loc"> 


name="fnam 


ET['msg'] == 'emptyparams'){ 





id="" 





fname"/> 











<inpu 
<inpu 


type="tex 











Lyp 














<input 
form> 
<div 
</body> 
SLLGE 
func 


</ 











type="tex 
tion check() 
Var 




















if(!fname) 
alert( 
饭店 名 称 不 能 为 空 ')，; 


return 
} 





{ 








PF- 


f(!loc)t{ 
alert(" 
饭店 位 置 不 能 为 空 ')，; 


return 
} 


if(!la 
































tLng) { 
alert("' 
获取 饭店 位 置 经 纬度 错误 ， 


return 
} 


return true; 











} 
</script> 
</html> 


效果 如 图 7-22 所 示 。 


{ 


fname = document .det] 
Var loc = document .get] 
Var latLng = document . det] 


false; 


false; 





请 重 试 ') ; 

















false; 


id="container"></div> 


t/javascript"> 


Element] 


t" id="loc" name="loc"/> 
"hiddqen" igd="latLng" name="latLng"/> 
type="submit"/> 





By] 





[Id("fname") .value; 








Element] 











By 


Id("loc") .value; 


























Element 





BylId("latLng") .value; 


lng; 





| .address; 


tion="saveaddloc.php" method="post" onsubmit="return check();"> 
] fname"> 


(4 添加 饭店 _ 免 子 饭庄 





饭店 名 称 
海淀 总 店 
饭店 位 置 
中 国 北京 市 海淀 区 ; 





淀 大 街 38 号 







是 号 上 
= E 
阵 : 下 
| A ' 每 混 多 | 海 定 民 育 中 心 铁 
| 裕 商 如 
z | 二 章 反 证 公园 [车 门 ]) 乾 : 博 天 和 商场 ie 
| 元 | 站 

; 站 二 证 路 攻 区 


] 





| 中 天 村 A 证 甘 村 户 汤 


| 和 得 园 南 社区 会 并 也 表征 和 
> 全 外 委 一 朋 创 语 大 大 
-0 一 海淀 南路 = 名 一 








BE 
El 


血浆 莹 顿 商 业 户 均 
基业 大 下 


上 号 


区 有 AS 1 器 大 1 
志和 腾讯 地 图 2014 Tencent6S(2014)6026 号 


图 7-22 


表单 校 验 通过 后 ， 数 据 被 提交 给 diner/saveaddloc.php， 该 文件 将 数据 存 入 数据 库 。 


<?php 
include once 'model/SaeDB.class.php'; 
Smysal = SaeDB: :getInstance () ， 
$fname = $mysql->escape($ POST [ 'fname']) 7， 
$loc = $mysql->escape ($ POST['loc']); 
$latLng = $mysql->escape($ POST['latLng']); 
list($Latitude,$Longitude) = explode(',', $latLng); 
if(!$fname || !S$loc || !$latLng){ 
header ("Location:addloc.php?msg=emptyparams");} 

























































































$sql = "INSERT INTO ‘diner locs (‘id’, ‘fname’, ‘loc’, "Latitude ’, Longitude’, ‘addtime ) VALUES (NULL, '‘'{$fname}', '{$loc}', '{$Latitude}', '{$Longitude}',CURRENT TIMESTAMP); 
$mysql->runSql ($sgl); 
if ($mysql->errno() != 0) 
{ 
die ("Error:" . $mysql->errmsg ()); 





} 
smysql->closeDb () ， 
header ("Location:1LIoclist.php") ， 








4. 获 取 用 户 位 置 


获取 用 户 位 置 有 两 种 方法 ， 第 一 种 为 主动 获取 ， 即 利用 微 信 的 地 理 位 置 服务 接口 ， 由 用 户主 动 上 报 ; 第 二 种 为 被 动 获取 ， 由 用 户主 动 发 送 地 理 位 置信 息 。 本 书 将 两 种 方法 相 结合 . 


主动 获取 用 户 位 置 ， 需 要 开启 获取 用 户 地 理 位 置 服务 。 开 启 时 会 弹出 如 图 7-23 所 示 的 提示 。 


温 苇 提 趟 


























































































































































































































请 选择 获取 地 理 位 置 的 模式 


i@) 息 户 进行 对 话 时 上 报 一 次 
二 用 户 进 行 对 话 后 天 隔 5$5 上 抠 一 次 





图 7-23 
在 本 需求 中 ， 只 是 获取 一 下 用 户 的 位 置 ， 不 需要 每 隔 3Ss 上 报 一 次 。 所 以 选择 用 户 进行 对 话 时 上 报 一 次 。 


如 果 公众 账号 开启 了 用 户 地 理 位 置 服务 ， 当 用 户 关 注 该 账号 时 ， 会 弹出 提示 ( 见 图 7-24) ， 询 问 用 户 是 否 允 许 使 用 你 的 地 理 位 置 。 





图 7-24 


当 用 户 允 许 时 ， 我 们 就 能 获取 用 户 位 置 。 这 样 当 用 户 点 击 “ 路 线 导航 ”菜单 项 时 ， 可 以 返回 路 线 导 航 图 ， 如 图 7-25 所 示 : 


如 果 对 隐私 比较 敏感 的 用 户 不 允许 应 用 主动 获取 自己 的 地 理 位 置 ， 则 可 使 用 被 动 获取 的 方法 获取 用 户 当前 位 置 。 当 获取 不 到 用 户 位 置 时 ， 我 们 给 用 户 发 送 一 个 文本 消息 进行 提示 ( 见 图 7-26) 。 
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图 7-25 





Cole “于 

= a u 

es | 
ee 用 Pe 





CE 
步行 竺 





【 免 子 饭庄 路 线 叶 朋 】 

三 碟 必 还 你 的 位 置 ， 即 吕 为 你 
拍 5| 到 音 个 分 店 线 路 : 

1. 点 击 算 直方" 小 访 盟 " 


2. 岂 击 打字 塘 口 劳 边 的 “+ 号 键 


Fe 


选择 "位 置 "图 标 





图 7-20 


这 时 用 户 可 以 将 位 置信 息 发 送 过 来 ， 如 图 7-27 所 示 : 





图 7-27 
这 时 就 可 以 获得 用 户 的 位 置 了 。 
5. 路 径 选 择 算法 


当 有 多 个 分 店 时 ， 默 认 导 航 到 距离 用 户 最 近 的 分 店 。 此 时 需要 确定 哪 家 分 店 距 离 用 户 最 近 。 一 个 城市 可 以 近似 为 平面 ， 用 户 位 置 和 饭店 位 置 可 以 近似 于 平面 的 两 点 ， 那 么 将 纬度 经 度 分 别 作为 x 轴 和 y 
轴 ， 两 点 的 “距离 ”就 可 以 用 下 面 的 算式 计算 : 


d= 





用 户 访 问 路 径 导 航 页 面 时 ， 就 出 现 如 图 7-10 所 示 的 带 有 起 点 、 终 点 、 路 径 标 识 的 地 图 。 路 径 导 航 功 能 在 diner/route.php 文 件 中 ， 完 整 代码 如 下 所 示 : 


<?php 
$title = " 
路 线 导 航 '; 
include 'header.php'; 
Smysal = SaeDB: :getInstance () ， 
$fromUserName = $mysql->escape($ GET['user']); 
$sql = "SELECT * FROM ‘dinner userlocs where FromUserName = '{$fromUserName}' order by “CreateTime desc limit 1"; 
$startdata = $mysql->getLine( $sql ); 
$sql2 = "SELECT * FROM ‘diner locs LIMIT 0 , 30"; 
$enddatas = $mysql->getData( $sgql2 ); 
smysql->closeDb () ， 
$closestLoc = array(); 
SclosestDistance = 0; 
foreach ($enddatas as S$enddata) { 
$sdistance = distance ($startdata, $enddata); 
if ($closestDistance == || $distance < S$closestDistance)f{ 
SclosestDistance = S$distance; 
$closestLoc = $enddata; 











































































































} 
} 
$startPoint = $startdatal'Latitude'] . ',' .$startdatal[l'Longitude'] ， 
SendPoint = S$closestLoc['Latitude'] . ',' .$closestLoc['Longitude']; 


// 
近似 计算 地 图 上 两 点 间 相 对 距离 






























































function distance ($start, $end)t{ 
$xl1 = $start['Latitude']; 
$yl = $start['Longitude']; 
$x2 = S$Send['Latitude']; 








$y2 = $end['Longitude']; 

































































return sqrt (pow ($x1-$x2, 2)+pow ($yl-$y2, 2)); 
。 
<script charset="utf-8" src="http://map.gqgq.com/api/js?v=2.exp"></script> 
Hoript> 
Var map, 
transfer plans, 
start marker, 
end marker, 
station markers = [], 
transfer lines = [], 
walk lines = []; 
var transferService = new qq.maps.TransferService ({ 
location : " 
比 永 名 
complete : function (result) { 
result = result.detail; 
Var start = result.start, 
nd = result.end; 
Var anchor = new qq.maps.Point (6, 6), 
size = new qq.maps.Size(24, 36), 
// 
标识 起 点 





start icon = new qq.maps .MarkerImage ( 
'http://open.map.qq.com/javascript v2/sample/img/busmarker.png',size 





) ， 
// 
标识 终点 





end icon = new qq.maps.MarkerImage ( 
'http://open.map.qq.com/javascript v2/sample/img/busmarker.png', 
size, 
new qq.maps.Point (24, 0), 
anchor 





); 
start marker && start marker.setMap (null); 
end marker && end marker.setMap (null); 
start marker = new qq.maps.Marker ({ 

icon: start icon, 

position: start.1latLng, 
map: map, 
ZzIndex:1 

















}); 
end marker = new qq.maps.Marker ({ 
icon: end icon, 

position: end.latLng, 

map: map, 

ZzIndex:1 





}); 
transfer plans = result.plans; 

Var plans desc=[]; 

for(var i = 0;i < transfer plans.length; i++){ 

//plan desc. 

Var p attributes = | 
'onclick="renderPlan('+i+')"', 
'onmouseover=this.style.background="#eee"', 
'onmouseout=this.style.backgroungd="#fff"™"", 






































] .join(' '); 
plans desc.push('<p ' + p attributes + 
'><b> 加 
方案 '+ (i+1)+' .</b>'); 
Var actions = transfer plans[i].actions; 
for(var j=0;j<actions.length;j++) { 
Var action = actions[j], 
img position; 
action.type == gq.maps.TransferActionType.BUS &&( 






























































img position = '-38px Opx' 

); 

action.type == gq.maps.TransferActionType.SUBWAY &&( 
img position = '-57px Opx' 

); 

action.type == gq.maps.TransferActionType.WALK &&( 
img position = '-76px Opx' 

); 

Var action img = '<span style="margin-bottom: -4px;'+ 





'display:inline-block;background:url (img/busicon.png) '+ 
'no-repeat '+img positiont+ 
';width:19px;height:19px"></span>&nbsp; Egnbsp;" }; 

plans desc.push(action img + action.instructions); 








} 
// 
方案 文本 描述 
document .getElementById('plans') .innerHIML=p1ans desc.join('<br><br>"'); 


// 
泻 染 到 地 图 上 


renderPlan (0); 





























} 
}); 
function init() { 

map = new qq.maps.Map (document .getElementByld("container"), { 


// 
地 图 的 中 心地 理 坐 标 


center: new qq.maps.LatLng (<?php echo $startPoint;?>) 






























































计算 换 乘 方案 
function calcPlan() { 
Var start name = "<?php echo $startPoint; ?>".split(','); 
Var end name = document .getElementByld ("end") .value.split("™,"); 
Var policy = document .getElementById ("policy") .value; 
transferService.search (new gq.maps.LatLng (start name[0], start name[l]), new gq.maps.LatLng (end name[0], end name[1])); 
switch (policy){ 
Case " 

































































较 快捷 " 
transferService.setPolicy (gqq.maps 
break; 
Case " 
少 换 乘 ": 
transferService.setPolicy (gqq.maps 
break; 
Case " 
少 步 行 ": 
transferService.setPolicy (gqq.maps 
console.1o09g(1); 
break; 
Case " 
不 坐 地 铁 ": 
transferService.setPolicy (gqq.maps 
break; 
} 
} 
// 
清除 地 图 上 的 标记 














function clearOverlay (overlays){ 
var overlay; 
while (overlay = overlays.pop())t{ 

overlay.setMap (nul1); 











} 
} 
function renderPlan (index) { 
var plan transfer plans[indexl], 
lines = plan.lines, 
walks = plan.walks, 
stations = plan.stations; 
map.fitBounds (plan.bounds); 
earOverlay (station markers); 
clearOverlay (transfer lines); 
clearOverlay (walk lines); 
Var anchor = new qq.maps.Point (6, 6), 
size = new qq.maps.Size (24, 36), 
bus icon = new qq.maps.MarkerImage ( 
'img/busmarker.png', 
size, 
new qq.maps.Point (48, 0), 
anchor 
), 

subway icon = new qq.maps.MarkerImage ( 
'img/busmarker.png', 
size, 
new qq.maps.Point (72, 0), 
anchor 






























































) i 
//draw station marker 
for{var J 0; ] < stations. length; J++)1 
Var station = stations[j]; 





























if(station.type == qq.maps.PoiType.SUBWAY STATI 
var station icon=subway icon; 

}elsel{ 
var station icon=bus icon; 





} 
var station marker new qq.maps.Marker ({ 
icon: station icon, 

position: station.latLng, 

map: map, 

zIndex:0 











}); 


station markers.push (station marker); 


//draw bus line 
for(var ] = 0; ] < lines.length; j++){ 
var line lines[j]; 
Var polyline = new qq.maps.Polyline ({ 
path: line.path, 





strokeColor: '#3893F9', 
strokeWeight: 6, 
map: map 


}); 
transfer lines.push (polyline); 


} 


























//draw walk line 
for(var ] = 0; j < walks.length; j++){ 
Var walk = walks[j]; 
Var polyline = new qq.maps.Polyline ({ 
path: walk.path, 
strokeColor: '#3FD2A3', 
strokeWeight: 6, 
map: map 


}); 
walk lines.push (polyline); 
} 
} 
</script> 
</head> 
<body onloagd="init () "> 
<div class="block"> 
<b> 
选择 分 店 : </b> 
<div class="select"> 
<select id="end" onchange="calcPlan();"> 























.TransferActionType.L 


.TransferActionType.LEAST WALKI 




















PAST T 





.TransferActionType.LEAST TRANSFER); 




















NG); 








.TransferActionType.NO SUBWAY); 





LON) { 


.$enddata[l'Longitude']; 








selected='selected'>{$enddatal ': 





echo “<option value="' {$endPoint}'>{$enddata[l'fname']}</option>"; 


<?php 
foreach ($enddatas as Sengddata) { 
$endPoint = S$Senddata[l'Latitude'] . ', 
if($Senddata['id'] == $closestLoc['id'])t{ 
echo "<option value="' {$endPoint}' 
}elsef 
} 
} 
?> 
</select> 
</div> 
</div> 
<div class="block"> 
<b> 


换 乘 策略 : </p> 


<div class="select"> 
























































<select id="policy" onchange="calcPlan();"> 
<option value="LEAST TIME."> 
较 快 捷 </option> 
<option value="LEAST TRANSFER"> 
少 换 乘 </cption> 加 
<option Value="LEAST WALKING"> 
少 步 行 </option> 和 
<option value="NO SUBWAY"> 





不 从 地铁 </option> 
</select> 
</div> 
</div> 
<div id="container"></div> 
<div igd="plans"></div> 
</body> 
</html> 


7.3 ”本章 小 结 


fname'] }</option>"; 


本 章 介 绍 了 一 个 为 兔子 饭庄 设计 开发 的 “餐厅 管家 ”， 介 绍 了 预约 管理 、 莱 单 管 理 、 二 维 码 优惠 券 及 路 线 导 航 等 餐饮 类 常见 功能 的 开发 过 程 。 本 章 用 到 了 微 信 公众 平台 的 多 个 接口 ， 包 括 生成 带 参 数 的 
二 维 码 、 消 息 接口 、 微 信 Js 接 口 、 地 理 位 置信 息 服务 、 自 定义 菜单 、 事 件 推送 等 。 并 且 介 绍 了 如 何 使 用 HTML 5 的 Websocket 进 行 编程 以 及 利用 腾讯 地 图 的 地 图 APl 来 进行 地 理 位 置 服 务 的 开 帮 。 相 信 通 过 本 
章 的 学 习 ， 读 者 能 举一反三 ， 开 发 出 更 好 的 餐饮 类 微 信 公众 账号 。 


随 着 微 信 5.0 的 发 布 ， 微 信 支 付 作为 一 个 新 兴 的 移动 支付 方式 ， 开 始 频频 出 现在 人 们 面前 。2014 年 5 月 9 日 ， 微 信 推 出 多 客服 功能 ; 5 月 27 日 京东 在 微 信 平 台 的 “购物 ”一 级 入 口 启 动 上 线 ; 5 月 29 日 增加 
微 信 小 店 功 能 ， 已 接 入 微 信 支付 的 服务 号 可 快速 开店 。 微 信 一 系列 的 行动 表明 : 微 信 支付 绝对 不 是 一 个 纯粹 的 支付 工具 ， 它 是 整合 微 信 整体 开放 能 力 的 一 整套 商业 解决 方案 ， 是 移动 互联 网 场景 下 ， 线 上 到 
线 下 消费 闭环 的 关键 环节 。 本 章 围绕 微 信 支 付 ， 从 一 个 微 商场 的 案例 ， 介 绍 一 个 抽奖 系统 的 设计 与 实现 、 微 信 支 付 、 微 信 小 店 和 多 客服 功能 ， 和 希望 能 对 进军 移动 电 商 的 读者 有 所 帮助 。 


8.1 ”抽奖 系统 


为 吸引 顾客 和 刺激 消费 ， 商 城 经 党 需要 做 些 抽奖 促销 活动 。 微 信 开 放 微 信 文 付 和 微 信 小 店 接口 之 后 ， 商 家 可 以 有 属于 自己 的 电 商 平台 ， 这 样 商家 可 以 在 平台 上 开发 自己 的 抽奖 系统 ， 来 进行 商品 促销 和 
吸引 客流 。 一 个 完整 的 抽奖 系统 分 为 以 下 三 部 分 : 


* 前 端 展 示 与 抽奖 动作 ， 和 包括 显示 抽奖 规则 ， 抽 奖 界面 ， 抽 奖 动作 及 处 理 抽奖 结果 。 
“ 抽奖 控制 逻辑 ， 包 括 权 限 控制 ， 产 生 抽 奖 结果 等 。 
* 奖品 及 中 奖 逻 辑 设 置 ， 包 括 奖品 的 种 类 与 数量 ， 中 奖 概率 等 。 


本 节 以 水 果 机 为 例 ， 介 绍 一 个 完整 的 抽奖 系统 的 设计 及 实现 过 程 。 


抽奖 机 有 很 多 种 类 ， 常 见 的 有 幸运 转盘 、 水 果 机 、 大 富翁 、 磺 金 蛋 。 昌 然 以 上 抽奖 机 的 展示 页 面 完 全 不 同 ， 抽 奖 动画 也 干 差 万 别 ， 但 万 变 不 离 其 宗 ， 都 是 向 后 台 程 序 请 求 中 奖 数据 ， 再 分 别 进行 前 端 显 


水 果 机 的 界面 和 规则 如 图 8-1 所 示 。 




















抽奖 规则 


1. 操 击 开 始 ， 水果 即 开始 转动 


2. 待 水 果 静 止 ， 出 现 相同 的 水 果 时 表示 您 中 奖 , 获 
得 奖励 。 


3. 出 现 不 同 的 水 果 时 表示 您 未 中 闯 , 请 再 接 再 厉 。 


抽 中 奖品 后 ， 页 面 会 弹出 中 奖 提示 ， 同 时 水 果 机 显示 三 个 相同 的 图 案 ， 如 图 8-2 所 示 。 


未 抽 中 时 ， 弹 出 未 中 奖 提 示 ， 同 时 水 果 机 显示 不 同 的 水 果 图 案 ， 如 图 8-3 所 示 。 





运气 牵 了 点， 由 接骨 历 吧 





oo 
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点 击 抽奖 后 ， 三 个 图 案 依次 开始 转动 ， 转 速 慢 慢 加 快 ， 再 渐渐 减 慢 ， 最 后 停 在 窗 格 中 。 这 个 动画 有 以 下 三 个 要 素 : 
. 使 图 案 停 在 窗 格 中 

. 转速 的 变化 

. 三 个 图 案 的 停留 位 置 


抽奖 的 奖品 图 片 是 一 个 长 方形 图 案 ， 每 个 小 图 案 高 度 为 50px， 相 邻 图 案 间 隔 10px， 如 图 8-4 所 示 。 使 图 案 停 在 窗 格 中 ， 原 理 就 是 用 CSS 的 background 背 景 属性 ， 通 过 规定 背景 图 像 的 位 置 来 显示 窗 格 范 
围 内 的 图 片 ， 同 时 隐藏 其 他 部 分 图 片 的 效果 。 


ee TR EPE TEST 











本 例 中 的 转速 的 变化 是 利用 Query 动 画 效果 扩展 增强 插件 jquery.easing.js 来 实现 的 。 


如 果 后 台 返 回 结果 为 已 中 奖 ， 那么 前 端 需要 三 个 图 案 都 停留 在 中 奖 的 图 案 处 。 抽 奖 图 片 的 高 度 为 360px， 在 这 种 情况 下 ， 三 个 图 案 在 y 方 向 上 的 差 值 ， 应 该 为 360px 的 整数 倍 。 


8.1.3 ”中 奖 概率 


在 处 理 中 奖 概率 时 ， 通 常 有 两 种 环境 : 
“ 测试 环境 。 中奖 率 高 ， 便 于 测试 各 种 中 奖 情况 ,正式 上 线 时 需 下 摔 。 
“ 线 上 环境 。 中 奖 率 按 实际 预算 设 定 ， 不 易 中 奖 。 


本 节 中 ， 测 试 环境 的 奖品 配置 文件 如 下 : 





File: shop/devaward.config.php 








<?php 
SawardConfig = array( 
1 => array('awardID' => 1, "name '=>" 


草莓 'num' => 1000,，'probability' => 0.1)， 
2 => array('awardID' => 2, 'name'=>" 
橘子 "num' => 1000，'probability' => 0.1)， 
3 => array('awardID' => 3, 'name'=>" 
葡萄 ', 'num' => 1000， "Probability' => 0.1)， 
4 => array('awardID' => 4, 'name'=>" 
西瓜 ', "num' => 1000，'probability' => 0.1)， 
5 => array('awardID' => 5, ‘'name'=>" 
西红柿 ', 'num' => 1000,，'probability' => 0.1)， 
6 => array('awardID' => 6, "name '=>" 
香蕉 ', 'num' => 500，'probability' => 0.1)， 





























线 上 奖品 的 配置 文件 如 下 : 





File: shop/award.config.php 

<?php 

SawardConfig = array( 
1 => array('awardID' => 1, ‘name'=>" 

草莓 "num' => 100，'probability' => 0.01)， 
2 => array('awardID' => 2, 'name'=>" 

橘子 'num' => 10，'probability' => 0.001)， 
3 => array('awardID' => 3, "name '=>" 

葡萄 "Inum' => 1000， "Probability' => 0.01)， 
4 => array('awardID' => 4，'name '=>" 

西瓜 "num' => 1, 'probability' => 0.0001) ， 
5 => array('awardIiD' => 5, 'name'=>" 

西红柿 ', 'num' => 10,，'probability' => 0.001)， 
6 => array('awardID' => 6, 'name'=>'" 

香蕉 ', 'num' => 50， "probability' => 0.01)， 
































这 里 存在 一 个 问题 ， 如 何 根据 给 定 的 概率 probability， 抽 选 出 相应 的 奖品 ? 


这 里 将 概率 probability 映 射 到 0-1 的 数 轴 上 ，probability 代 表 一 段 线 段 的 长 度 ， 这 样 线段 的 长 度 就 是 概率 ， 如 图 8-5 所 示 。 


probability=0.1 





图 8-5 
对 于 线 上 环境 的 奖品 配置 ， 利 用 上 述 算法 运行 1000000 次 的 测试 结果 如 表 8-1 所 示 ， 误 差 很 低 . 
表 8-1 
中 奖 id 理 论 值 实 测 值 误 差 


0(〈 未 中 奖 ) 0.9679 0.967733 0.000147 
1 0.01 0.010198 0.000198 
2 0.001 0.001017 1./ 上 -0> 
0.010023 2.3E-03 
0.000109 0.000009 


0.000970 0.000024 


hn 
一 
OO 
OO 
po— 


(人 

一 
OO 
| 


0.009924 1.6E-03 


8.1.4 ”抽奖 控制 逻辑 


设计 一 个 抽奖 系统 ， 最 重要 的 是 防止 被 刷 ， 包 括 抽奖 次 数 、 中 奖 奖品 、 抽 奖 权限 等 。 一 旦 出 现 奖品 被 刷 问 题 ， 要 么 超出 预算 ， 要 么 影响 信誉 。 这 里 考虑 四 种 控制 逻辑 。 
(1) 限制 在 微 信 中 抽奖 
这 里 对 前 端 Js 和 后 端 抽 奖 接口 都 要 进行 限制 。 


笔者 发 现 ， 前 端 JS 在 某 些 手机 上 利用 ua 进行 判断 时 ， 会 出 现 判断 失误 的 问题 。 考 虑 到 微 信 内 置 浏览 器 中 有 特有 的 WeixinJsBridge 对 象 ， 所 以 我 们 可 以 利用 WeixinJSBridge 来 判断 当前 浏览 器 是 否 为 和 
内 置 浏览 器 ， 具 体 代码 如 下 : 


// 

判断 当前 浏览 器 是 否 为 微 信 浏 览 器 

function checkMicroMessenger () { 

var pattern = /MicroMessenger/ig; 

if (pattern.test (navigator.userAgent))1{ 
EE 

} 























Lurn Urue; 











if (typeof WeixinJSBridge == "object")f{ 
return true; 

}elsel{ 
return false; 


l 


























} 


} 

同时 PHP 

需要 判断 请 求 是 否 来 自 微 信 浏览 器 ， 代 码 如 下 : 

function checkMicroMessenger () { 

return preg match("/MicroMessenger/i", $ SERVER['HTTP USER AGENT']); 
} 





















































(2) 利用 openid 限 制 身份 

openid 可 以 通过 OAuth2.0 网 页 授权 来 获得 ， 详 情 见 第 5 章 。 
(3) 限制 抽奖 次 数 

(4) 限制 中 奖 次 数 


另外 需要 记录 抽奖 次 数 、 抽 奖 结果 及 用 户 中 奖 情况 等 ， 以 便 排 除 被 刷 逻 辑 、 校 验 用 户 中 奖 真实 情况 等 。 


8.1.5 ”数据 表 设 计 


这 里 需要 一 个 表格 ( 见 表 8-2) 来 记录 用 户 的 抽奖 结果 。 


表 8-2 


多 E 键 标识 ， 自 增 
openid 用 户 的 openmid， 唯 一 标识 用 户 号 份 
awardid 奖品 id，0 为 未 中 奖 


seq varchar 抽奖 序列 号 ， 具 有 唯一 性 


其 中 seq 为 0openid 和 服务 器 时 间 组 成 的 字符 串 经 md5 hash 之 后 的 值 。 因 为 openid 对 各 用 户 唯一 ， 服 务 器 时 间 又 对 每 个 用 户 唯一 ， 所 以 能 保证 seq 的 唯一 性 。 


创建 抽奖 记录 表 的 代码 如 下 : 





表 的 结构 `shop lottery. 
































CREATE TABLE IE NOT EXISTS ‘shop lottery ( 
“id int(10) NOT NULL AUTO NCREMENT COMMENT ' 
主键 l 三 
‘openid. varchar (100) NOT NULL, 
‘awardId. tinyint (2) NOT NULL, 
‘seq varchar(32) NOT NULL, 
“addtime timestamp NOT NULL DEFAULT CURRENT TIMESTAMP, 
PRIMARY KEY (“id.) 本 
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT=" 
抽奖 记录 表 ' ; 

















































































































8.1.6 代码 实现 


自 定 义 菜单 要 用 URL 跳 转 实 现 OAuth 2 网 页 授权 ， 以 此 来 获得 用 户 的 openid， 完 整 代码 如 下 : 




















File:shop/create menu.php 

<?php 

require "lib/weixin.class.php";// 
引入 微 信 类 文件 
$codeurl] = weixin::createCodeUrl ('snsapi base', 'lottery', 'http://devweixin.sinaapp.com/shop/choujiang.php'); 
//Smenu 

变量 为 存放 菜单 项 的 json 




















"button": [ 
{ 
"type"™ 。 "ViIewn 5 
"name™ : 1 


TCF .$codeurl.,' 


$ret = weixin::createMenu ($menu);// 
创建 菜单 

if($ret){// 

创建 成 功 


echo 'create menu ok'; 











echo "create menu fail'; 


} 
?> 


前 端 需要 展示 抽奖 界面 、 抽 奖 动作 及 抽奖 结果 展示 ， 完 整 代 码 如 下 : 


File:shop/choujiang .php 

<?php 

require 'lib/common.func.php'; 
require 'lib/weixin.class.php'; 
$sopenid = 0; 

人 'T['code'])t{ 





























et = weixin: :getAuthToken($ GET['code']);// 
网 页 接 匀 获取 月 秽 9 
if(isset ($ret['openid'])){ 








$Sopenid = $ret['openid']; 
} 
} 














2 

<!DOCTYPE HTML> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 











<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 

<meta name="apple-mobile-web-app-capable" content="yes" /> 

<title> 

水 果 抽 
微 商城 </title> 

<link rel="stylesheet" type="text/css" href="public/shop.css"/> 
</head> 

<body> 

<div class="container"> 

<div class="frutmachine"> 

<div class="mask maskl"></div> 

<div class="mask mask2"></div> 

<div class="mask mask3"></div> 




























































































<a class="share" href="javascript:void(0);"> 
开始 抽奖 吧 ， 少 年 </a> 

</div> 

</div> 

<div> 

<h3> 

抽奖 规则 </h3> 

«B21 

点 击 开始 ， 水 果 即 开始 转动 </p> 

<p>2. 

待 水 果 静 止 ， 出 现 相同 的 水 果 时 表示 你 中 奖 ， 





























获得 奖励 。</P> 

<p>3. 

出 现 不 同 的 水 果 时 表示 你 未 中 奖 ， 

请 再 接 再 万。</P> 

</div> 

<script type="text/javascript" charset="utf-8" src="http://lib.sinaapp.com/js/jquery/1.9.0/jquery.min.js"></script> 
<script type="text/javascript" charset="utf-8" src="public/jquery.backgroundPosition.js"></script> 

<script type="text/javascript" charset="utf-8" src="public/jquery.easing.js"></script> 

<script type="text/javascript"> 


Lk 

判断 当前 浏览 器 是 否 为 微 信 浏览 器 

function checkMicroMessenger () { 

var pattern = /MicroMessenger/ig; 

if (pattern.test (navigator.userAdent) ) { 
下 

} 




























































































个 EU ELEUS7 


























elseli 

if (typeof WeixinJSBridge == "object")f{ 
return true; 

}elsef 

return false; 











] 
} 
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产生 1 

到 |n 

之 间 的 随机 数 

function getRandom(n){ 

return Math.floor (Math.random()*n+1);} 



































//0 
草莓 ---1 
橘子 ---2 
葡萄 ---3 
西瓜 ---4 
西红柿 ---5 
香 态 
$ (function () { 
var isBegin = false;// 























是 否 开始 抽奖 
var itemHeight = 50;// 
抽奖 图 片 中 单个 奖品 高 度 
Var itemPadding = 10;// 
抽奖 图 片 中 两 个 相 邻 奖品 的 高 度 间隔 
var picHeight = 360;// 
妈 片 高 度 
var randomPadding = getRandom(50);// 
停靠 位 置 随机 化 
$('.container .share') .click (function()f{ 
f(isBegin) return false; 


f(!checkMicroMessenger () ) { 


1 1 
请 在 微 信里 抽奖 1 中 了 


return false; 
































Cd 
bs 
Da 




































































jsBegin = true; 
$(".frutmachine .mask") .css('backgroundPosition','6px 4px'); 
$.post ("lottery.php", {'id':'<?php echo S$openid;?>' }, function (resulty status) { 
Var data = JSON.parse (result); 
if(datal'result'] == -2){ 
alert (datal'msg']); 
return false; 

















} 

$s(".frutmachine .mask") .each (function (index){ 
Var num = $ (this); 
setTimeout (function (){ 

















_num.animate ({ 

backgroundPosition: "6px '+(picHeight*5+((itemHeight+itemPadding)*(7-datal['info'] [index])+randomPadding))+'px' 
} 1{ 

duration: 6000+index*3000, 

easing: "easeInOutCirc", 

complete:function () { 

if (index===2){ 

ijsBegin = false; 

if(data['result'] == 0)1{ 




















alert("' 

















运气 差 了 点 ， 再 接 再 厉 吧 ') 








alert('" 
共 喜 你 抽 中 '+data['msg']); 





上} 
}, index * 300) ， 


a A 
~ 一 
NA 


}) 
</script> 
</body> 
</html> 


后 端 程序 需要 处 理 抽奖 控制 逻辑 、 中 奖 逻辑 ， 记 录 操 作 日 志 等 ， 完 整 代码 如 下 : 


File:shop/Lottery.Php 
<?php 
f(!checkMicroMessenger () ) { 

$ret = array('result'=> -2,'msg'=>" 
不 是 微 信 浏 览 器 ', 'info' => "''); 
echo json encode ($ret); 
exit(); 
} 
require 'lib/common.func.php'; 
include once 'model/SaeDB.class.php'; 
Smysal = SaeDB: :getInstance () ， 
$openid = Smysql->escape($ POST['iq7']) 





卢 - 








pp 

























































































$selectSql = "SELECT COUNT( * ) FROM ‘shop lottery WHERE ‘openid. LIKE '{$openiqd}'"; 
ScountData = $mysql->getLine( $selectSal ); 
$count = reset ($countData); 
if(S$Scount >= 5){ 
$ret = array('result'=> -2,'msg'=>" 
抽奖 机 会 已 用 完 ', 'info' => ''); 








echo json encode ($ret); 
exit (); 
} 
sae log("openid:{$openid},count:". Var export($count, true));// 
记录 抽奖 次 数 加 
Senv = 'develop';// 
环境 切换 ，develop 
为 开发 环境 ，product 
为 线 上 环境 
if($env == 'product"')t1 
require ‘award.config.php'; 
}else if(Senv == 'develop'){ 
require ‘devaward.config.php'; 
} 
YY 
查询 中 奖 次 数 
$selectSsgl = "SELECT COUNT( * ) FROM “Shop lottery WHERE ‘openid LIKE '{$openid}' AND ‘awardId !=0"; 
ScountData = $mysql->getLine( $selectSql ); 
$count = reset ($countData); 
if($Scount >= 1){// 
如 果 已 经 中 一 次 奖 ， 则 不 再 中 奖 
SawardId = 0; 
sae log ("openid: {S$openid}, 
已 经 中 过 有 奖 ") ;// 







































































































































































































































































户 中 奖 情况 
} else { 
SawardId = getLottery ($awardConfig); 
} 
if (S$SawardId == 0){ 
$ret = array('result'=> 0,'msg'=>'" 
谢谢 参与 ', 'info' => array rand ($awardConfig,3)); 
} else { 
$ret = array('result'=> S$SawardId, 'msg'=>$awardConfig[$awardId] ['name'],'info' => array ($awardId, $awardId, $awardId) ) 
} 
sae log("openid:{$openid},Lottery Result:". Var export ($ret, true));// 
记录 下 抽奖 结果 
$seq = md5 ($openid. time()); 
$sql = "INSERT INTO ‘shop lottery (id’, ‘openid’, ‘awardId’, seq , ‘addtime’) VALUES (NULL, '{$openid}', '{$awardId}', '{$seq}',CURRENT TIMESTAMP);"; 
SmysaqlL->runSdql ($sql); 
smysql->closeDb (); 





echo json encode ($ret); 


判断 当前 浏览 器 是 否 为 微 信 浏 览 器 
function checkMicroMessenger () { 
return preg match("/MicroMessenger/i", $ SERVER['HTTP USER AGENT']); 
} 
/7 
抽奖 
function getLottery (SawarqConfid) { 
SrandomNum = randomFloat () ， 
sluckId = 0; 
foreach ($awardConfig as Sitem) { 
$spice = $item['awardID'] /10.0 :; 
$sub = S$randomNum -$spice; 
f($sub > 0 && $sub <= $item['probability'])t{ 
$luckId = $item['awardID"']; 
break; 
























































PP- 








} 
} 


return $luckId; 








到 1 
之 间 的 浮 点 数 

function randomFloat ($min = 0, S$max = 1) { 

return $min + mt rand() / mt getrandmax() * ($max -$min); 


} 








8.2 人 微 信 文 付 


2014 年 3 月 4 日 ， 微 信 支 付 正式 开放 申请 ， 所 有 通过 认证 的 服务 号 都 可 以 申请 。 这 是 移动 支付 领域 的 一 件 大 事 。 在 此 之 前 ， 只 有 极 少 部 分 商家 获得 了 内 测 资格 ,包括 易 迅 、 大 众 点 评 等 。2014 年 春节 的 微 
信 红 包 活 动 ， 除 了 让 人 们 看 到 了 电 商 与 社交 结合 而 成 的 引爆 点 外 ， 还 将 微 信 支 付 普及 到 上 百 万 的 用 户 。 用 户 感慨 原来 支付 可 以 如 此 便捷 ， 而 获得 内 测 资 格 的 商家 则 大 赚 特 赚 。 


微 信 支付 开放 申请 ， 意 味 着 微 信 的 “入 口 ” 和 “支付 ”形成 闭环 ， 用 云 科技 程 蕉 峰 的 话说 是 微 信 取得 “制空权 ”。 对 广大 商家 而 言 ， 有 粉丝 ， 有 互动 ， 有 上 反馈 ， 有 支付 ， 各 个 行业 都 可 以 在 微 信里 鞍 勃 
发 展 。 更 幸运 的 是 ， 微 信 文 付 以 及 与 之 关联 的 电 商 平台 ， 一 出 现 就 以 开放 的 姿态 面世 。 凡 是 “国家 队 ” (业内 称 微 信 官 方 或 与 微 信 有 合作 关系 的 企业 ) 推出 的 功能 ， 全 部 开放 出 API 接 口 ， 供 商家 或 第 三 方 开 
发 者 做 进一步 的 开发 。 例 如 微 信 小 店 、 多 客服 等 ， 可 以 使 用 公众 平台 提供 的 编辑 功能 ， 也 可 以 自行 开发 软件 或 插件 。 


接 下 来 详细 介绍 一 下 微 信 支 付 的 流程 和 实现 。 


微 信和 支付 可 以 分 为 两 种 : 公众 号 支付 及 APP 支 付 。 对 于 没有 公众 账号 的 用 户 ， 可 以 到 微 信 开 放 平台 open.weixin.qq.com 申 请 开通 APP 支 付 权限 。 下 面 如 果 没 有 特殊 说 明 ， 微 信 支 付 均 指 公众 号 支付 。 


微 信 为 商家 提供 了 一 套 完整 的 移动 购物 解决 方案 。 以 微 信 支 付 为 核心 功能 ， 微 信 官 方 提 供 了 用 户 身份 识别 、 微 信 地 址 共享 、 支 付 结算 、 客 户 关系 维护 、 售 后 维权 、 交 易 统计 的 整套 移动 购物 解决 方案 。 
图 8-6 是 微 信 支 付 在 整个 移动 购物 解决 方案 中 所 处 的 位 置 。 





商品 二 维 码 
线 下 扫 码 , 直接 选 购 JS 





一 中 二 了 || = = 


各 种 ; 肖 己 己 深 秆 ， 直 措 两 


品 详情 


微 信 文 付 按 支 付 方式 分 为 以 下 两 种 : 





购买 文 付 


微 信 支 付 


APl, Natrve、 中 PP 


效 据 分 本 
订单 流水 等 交易 信息 


共有 至 收 货 
收 货 地 址 数 


支付 后 推荐 关注 


在 新 用 户 支 付 后 推荐 关 
六 公众 写 


元 地 址 
闪 孚 


财 付 通商 家 上 
行 资金 下 
客服 维权 


客服 、 座 杭 接 口 ， 客 户 
甘 系 维护 


' 可 进 





.JS API 支 付 ， 指 利用 WeixinJSBridge 提 供 的 API， 调 用 支付 功能 ， 完 成 购买 流程 。 


. Native 支 付 ， 指 原生 支付 ， 用 具有 weixin://wxpay/bizpayutl 前 级 的 URL， 调 用 支付 功能 。 


微 信 支 付 所 需要 的 账号 体系 如 表 8-3 所 示 。 


账 号 
appld 


appSecret 


paySienKey 


partnerld 


partnerKey 


作 用 
公众 账号 身份 的 唯一 标识 。 审 核 通 过 后 ， 在 微 信 发 送 的 邮件 中 查看 


\ 众 账号 支付 请 求 中 用 于 加 密 的 密 钥 Key， 可 验证 商户 唯一 身份 
| 场景 中 的 appKey 值 。 审 核 通 过 后 ， 在 微 信 发 送 的 邮件 中 查看 


除了 支付 请 求 需要 用 到 paySignKey， 公 众 平 台 接口 API 的 权限 获取 所 需 密 钥 Key， 在 
使 用 所 有 公众 平台 API 时 ， 都 需要 先 用 它 去 换取 access token， 然 后 再 进行 调用 ( 详情 
参考 文档 API 接 口 部 分 ) 。 审 核 通 过 后 ， 在 微 信 发 送 的 邮件 中 查看 


财 付 通商 尸身 份 的 标识 。 审 核 通过 后 ， 在 财 付 通 发 送 的 邮件 中 碍 看 
财 付 通 商户 权限 密 钥 Key。 审 核 通过 后 ， 在 财 付 通 发 送 的 邮件 中 查看 


，PaySienKey 对 应 于 


2 
人 


文 


其 中 appSecret、paySignKey、partnerKey 是 验证 商户 唯一 性 的 安全 标识 ， 请 不 要 泄露 ， 也 不 要 写 在 页 面 中 。 


8.2.2 JS APIx 付 


由 于 微 信 支付 模块 在 微 信 5.0 版 本 之 后 引入 ， 因 此 使 用 Js APl 之 前 ,需要 确定 版 本 号 是 否 


大 于 等 于 5.0。 如 果 过 低 ， 则 调用 JS API 无 效 ， 需 提示 用 户 升级 或 采用 其 他 支付 手段 。 





<script type="text/javascript"> 
if(!checkWXVersion(5.0))1{ 
console.1og('" 
当前 版 本 小 于 5.0 
， 不 文 持 微 信 文 付 。 请 升级 微 信 版 本 '); 


}elsef 








执行 微 信 支 付 相关 代码 

} 

//miniversion 

为 最 小 可 支持 的 版 本 号 

function checkWXVersion (miniversion) { 


Var pattern = /MicroMessenger[\s\/]+([\d.]+)/ig, 
ua = navigator.userAgent; 

















Var match = pattern.exec(ua) || []; 
Var Vv = match[1] || 0 
return parseFloat (v) >= miniversion ? true : false; 
</script> 


如 果 已 经 确认 微 信 版 本 大 于 等 于 5.0， 就 可 以 调用 JS API 了 。 调 用 示例 如 下 : 











J invoke ('getBrandWCPayRequest', { 


qd" : getAppId(), // 
公众 号 名 称 ， ， 由 商户 传 入 











"timeStamp" : getTimeStamp(), // 
时 间 惟 

"nonceStr" : getNonceStr () ，// 
随机 串 

"package" : getPackage(),// 
扩展 包 

"signType" : getSignType(), // 
微 信 签名 方式 :1.shal 

"paySign" : getSign () // 
微 信 签名 





;function (res) { 

if (res.err msg == "get brand wcpay request:ok™" ) { 
WeixinJSBridge.1log('" 

支付 成 功 ! '); 


} 
二 

















注意 ， 所 有 传 入 参数 都 是 字符 串 类 型 ， 特 别 是 timestampP， 不 要 作为 数字 类 型 传 入 。 


字段 名 称 : 公众 号 id。 
字段 来 源 : 商户 注册 具 
传人 方式 : 
参数 类 型 : 字符 串 类 型 








支付 权限 EF 
由 商 上 


:1 月 1 日 00: 00: 00 至 今 的 秒 数 


参 数 
人 时 间 蕉 ， 

字段 来 源 : 商户 生成 从 1970 年 
timeStamp 最 终 需 要 转换 为 子 符 申 形 式 。 

传人 方式 : 由 商户 生成 后 传人 

参数 类 型 ， 字符 类 型 ， 

参数 长 度 : 32 个 字 节 以 下 

字段 名 称 : 随机 字符 串 ， 

字段 来 源 : 商户 生成 的 随机 字符 串 。 

nonceStr 是 传人 方式 : 由 商户 生成 后 传人 


参数 类 型 . 
参数 长 度 


4 答 中 类 型 
39 沾 学 节 忆 下 


WD 


Ms 众 写成 功 后 即 可 获得 


， 即 当前 的 时 间 ， 


日 


字段 名 称 : 扩展 字符 串 。 
参数 类 型 ; 字符 串 类 型 。 
字段 来 源 : 商户 将 订单 信息 组 成 该 字符 串 ， 具 体 组 成 方案 参见 接口 使 用 说 明 中 





package package 组 包 帮 助 。 

传人 方式 : 由 商户 按照 规范 拼接 后 传人 。 

参数 类 型 : 字符 串 类 型 。 

参数 长 度 : 4096 个 字 节 以 下 

字段 名 称 : 签名 方式 。 

参数 类 型 : 字符 串 类 型 。 
signType 字段 来 源 : 按照 文档 中 所 示 填 人 ， 目 前 仅 文 持 SHA1.。 

参数 类 型 : 字符 串 类 型 。 

参数 取 值 : "SHA1" 

字段 名 称 : 签名 。 

字段 来 源 : 商户 将 接口 列表 中 的 参数 按照 指定 方式 进行 签名 ， 签 名 方式 使 用 

signType 中 标示 的 签名 方式 ， 具 体 签名 方案 参见 接口 使 用 说 明 中 签名 帮助 。 

paySign 证 


传人 方式 : 由 商户 按照 规范 签名 后 传人 。 
参数 类 型 : 字符 串 类 型 。 
参数 长 度 : 40 个 字符 


微 信 官 方 给 出 了 公众 号 支付 的 demo ( 微 信 JS API 公 众 号 支付 测试 demo) ， 读 者 可 以 到 地 址 https://mp.weixin.qq.com/cgi-bin/readtemplate? 
t=business/course2 tmpl&lang=zh CN&token=1831503900 下 载 ， 如 图 8-7 所 示 。 


下 载 : 
《OAuth2.0 摇 权 》 
* 微 信和 公 座 号 支 付 接口 说 明 V2.2》 
* 收 贷 地 址 共享 接口 文档 V1.2》 
用 嘱 维 权 系 统 芝 明 忆 APL V1.638 
《 微 信 JS APIS 众 写 支 付 浏 寺 demo0) 二 


《 役 信 支付 SDK 电 新 史明 及 支 付 上 手指 南 _for_ IOS V10 (公信 有 ) 3》 
€iOS WeChatSDK1.4.1» 

4 币 信 支付 SDK 电 新 吉明 上 及 支付 上 手指 南 _for_Android_V10 (公克 反 ) 办 
*libammsdk 2.1.3 internal 20131ll4.zip» 
«sdk_sample_internal_20131028 ( 包含 支付 ) 》 





图 8-7 


下 载 的 demo 演 示 了 公众 号 支付 Js API 的 使 用 方法 。 其 中 最 重要 的 由 账号 体系 的 各 种 参数 及 订单 相关 数据 ， 包 装 成 请 求 字 符 串 。 代 码 如 下 : 


// 

获取 随机 数 

function getANumoer () { 

var date = new Date () 

Var times1970 = date.getTime () ， 
Var times = date.getDate() + "" + date.getHours() + "" 
Var encrypt = times * times1970; 

if (arguments.length == 1) { 
return arguments[0] + encrypt; 
} else { 

return encrypt; 














+ date.getMinutes() + "" + date.getSeconds () ， 

















} 
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以 下 是 package 

组 包 过 程 : 

Var oldPackageString; // 
记 住 package 

















， 方 便 最 后 进行 整体 签名 
function getPartnerI 
eturn document. 

















forml 


秆 取 用 
d() { 


.PartnerI 








d.value; 











tPar 





unction ge tnerKey 


() { 








eturn "893 














Eh hy 





Unc 
Var banktype = "WX"; 


1le71d15453e97507 








F794cf Ib0519gd"; 





tion getPackage() { 





var body = document 








// 


.forml .body.value; 








商品 名 称 信息 ， 这 里 由 测试 网 
Var 
费用 类 型 ， 这 
为 默认 的 人 民 

Var input 
字符 集 ， 这 里 将 统一 使 

var notify url = 


支付 成 功 后 将 通知 该 地 址 





























3 二 
己 

















用 GBK 























fee type 一 Ls . 


charset = 


"http://www.qq.com"; 








页 填 入 。 
// 





// 





"GBK"; 


// 





var out rad no = 


"" + getANumber (); // 





订单 号 ， 商 户 需 





要 保证 该 字段 对 于 本 商户 的 唯一 性 














Var partner = getPartner] 


测试 商户 号 
Var spbill 


_Create ip = 


[Id(); // 





"2700s LE 7 














户 浏览 器 的 IP 














测试 值 
Var total 
总 如 金 铬 会 多 页 全 


Var partnerkey = 

















这 个 值 和 以 上 其 他 值 不 一 样 是 : 





是 需 人 


fee = document. 





， 入 个 需要 在 前 端 获取 。 这 里 使 用 127.0.0.1 








forml . 





getPartnerKey(); // . 
而 最 后 组 成 的 传输 字符 串 不 能 含有 它 。 这 个 





签名 需要 它 ， 
































totalFee.value; 


// 


7 
A 
(0 

hg 





















































































































































































































































首先 第 一 步 : 对 原 串 进行 签名 ， 注 意 这 里 不 要 对 任何 字段 进行 编码 。 这 里 是 将 参数 按照 key=value 
进行 字典 排序 后 组 成 下 面 的 字符 串 ， 
在 这 个 字符 串 最 后 拼接 上 上 key 
。 由 于 这 里 的 字段 固定 ， 因 此 只 需要 按照 这 个 顺序 进行 排序 即 可 。 
Var SignString = "bank type=" + banktype + "&body=" + body + "&fee type=" + 工 typ 
Var md5SignValue = ("" + CryptoJS.MD5 (signString)) .toUpperCase(); 

// 
然后 第 二 步 ， 对 每 个 参数 进行 url 
转 码 ， 如 果 你 的 程序 是 用 js 
， 那 么 需要 使 用 encodeURIComponent 
函数 进行 编码 。 
banktype = encodeURIComponent (banktype); 
body = encodeURIComponent (body); 

fee typ ncodeURIComponent (fee type); 

input charset = encodeURIComponent (input charset); 

notify Url = encodeURIComponent (notify url); 

out trade no = encodeURIComponent (out trade no); 
partner = encodeURIComponent (partner); 

spbill create ip = encodeURIComponent (spbill create ip); 

total fee = encodeURIComponent (total fee); 

// 
然后 进行 最 后 一 步 ， 这 里 按照 key 
一 Value 
除了 sign 
外 进行 字典 序 排序 后 组 成 下 列 的 字符 串 ， 
最 后 再 串 接 sign=value 
Var completeString = "bank type=" + banktype + "&body=" + body + "“&f type=" f type + 
completeString = completeString + "&sign=" + md5SignValue; 








oldPackageString = 
记 住 package 














， 方 便 最 后 进行 整体 签名 时 取 用 





return completeSstring; 
} 
// 
下 面 五 是 入 
进行 签 答 侨 届 操 作 : 
Var oldTimeStamp; // 
记 住 timestamp 

避免 签名 时 i 
En to 

时 不 一 致 
var oldNonceStr; // 
记 住 nonceStr， 

避免 签名 时 的 nonceStr 
与 传 入 的 nonceStT 

不 一 致 
unction getAppI 
document. 









































d() { 





(0 
9 
[er 
加 
器 


completeString; 

















// 








d.value; 








unction getAppKey() { 








forml .apPI 


"2WozZy2aksielpuXUBPWD8o0ZxiD1DfQuEaiC7KCcRATV1I 























Fh BB hi 








unction getTimeStamp () 





timestamp = new Dat 


{ 





() .getTime (); 





Var 
一 定 要 转换 字符 串 


timestampstring = 七 Imestamp .toString () ; 











oldTimeStamp = timestampstring; 
return timestampstring; 





} 


function getNonceStr() 





{ 








Var Schars = 'ABCDEFGH 











Var maxPos = 
Var noceStr = "0"; 
EO (LOR L327 








} 
oldNonceStr = nocestr; 
return nocestr; 
} 
function getSignType() 
return "SHAl™; 




















tion getSign() { 
app id = getAppI 
app key = 
nonce st 
package string = 
time stamp = 


// 
第 一 步 ， 为 所 有 需要 传 入 的 参 
作 一 次 key 
一 Value 
字典 序 的 排序 
Var keyvaluestring = 
sign = CryptoySs. SHA 
return sign; 


} 





d() 











若 用 到 实际 工程 中 ， 有 以 下 两 点 ; 


JKLMNOPORSTUVWXYZabcde 

















+t "“&input charset=" + input charset + "&noti 











// 





fghijklmopgqrstuvwxyz0123456789';) 





schars.length; 


i++) { 
noceStr += $chars.charAt (Math. 





{ 


.toString () ， 


getAppKey () .toString () 
r= OLaqNoncesSt 
oldPackageString; 
oldTimeStamp; 


工 7 





数 加 上 appkey 


主意 事项 : 


floor (Math.random () 


* maxPos) )}; 





no3mdopKaPGOO7TtkNySuAmCaDCrw4xhPYSgqKT] 





"appigd=" + app id + "&appkey=" + app key + "&noncestr=" 
1 (keyvaluestring) .toString () ， 


appSectet、paySignKey、pattnerKey 是 验证 商户 唯一 性 的 安全 标识 ， 不 能 写 在 页 面 中 。 


“ res.etr_msg 将 在 用 户 支付 成 功 后 返 


因此 ， 需 要 用 后 


回 ok， 


百 台 程序 隐藏 安全 标识 及 确认 交易 信息 。 


但 并 不 保证 它 绝对 可 靠 。 正 确 的 做 法 是 当 收 到 ok 返 


POPC 


.Str 


回 时 ， 向 商户 后 








"&input charset=" + input charset + "&noti 





B17FZzmORgR3cOWaVYI 











XZARSxZHV2x7iwPPZOz94dnwPWSn";} 


fy url=" + noti 


£y url= "+ .not 





fy url + "&out trade no=" + out 





fy url + "&out trade no=" + 





上 im 





"&package=" + package string + "&timestamp=" 


台 询 问 是 否 收 到 交易 成 功 的 通知 。 


Stamp; 


8.2.3 ”安全 文 付 


为 了 不 在 页 面 上 出 现 appSecret、paySignKey、partnerKey 这 三 个 安全 标识 ， 同 时 隐藏 支付 签名 字符 串 的 生成 算法 ， 因 此 需要 用 后 


getAppld、getTimeStamp、getNonceStr、getANumber、getPackage、getSignType 和 和 getSign 等 方法 。 


首先 定义 账号 体系 的 五 个 参数 ， 代 码 如 下 : 


财 付 通商 户 id') ; 


define ('PARTNE] 


fine ("APPI 
众 号 jd' ) ; 





e ('PAYS 
付 签名 ')， 


e ('APPSE 
众 号 密 钥 Key') 


e ("PARTNER 

































































财 付 通 商户 密 钥 Key ') 


getAppld 函 数 的 作用 是 获取 公众 





/** 
人 





function getAppI 


return APPID; 


} 








六 


号 名 称 ， 


代码 如 下 : 


getTimestamp 函 数 的 作用 是 获取 时 间 戳 ， 其 值 为 从 UNIX 纪 元 (格林尼治 时 间 1970 年 1 月 1 日 00: 00: 00) 到 当前 时 间 的 秒 数 。 


/** 
I 








return strval (time{()):; 





} 


function getTimeStamp (){ 


getNonceStr 函 数 获取 一 个 32 位 的 随机 字符 串 ， 其 





























组 成 部 分 为 字母 和 数字 。 





/** 
大 
获取 随机 字符 串 
人 
function getNonceStr () { 
Schars = 'ABCDEFGHIJKLMNOPORSTUVWXYZabcdef 
$len = strlen ($chars); 
$noceStr = ™""} 
for ($i = 0; $i < 32; Si++) { 
snoceStr .= substr ($chars, rand(0, $len-1), 


return SnoceStr; 


} 


getANumber 函 数 由 时 间 戳 计算 出 一 个 随机 数 ， 用 来 作为 订单 号 。 商 户 需要 保证 该 字段 对 于 本 商户 的 唯一 性 。 实 际 工程 中 ， 还 应 向 数据 库 查 询 生 成 的 随机 数 是 人 否 已 经 


/** 


大 


获取 随机 数 


* Qreturn 七 
*/ 


function get 





return StimeS 


} 





ype 
ANumber () { 





StimeStamp = time()， 





tamp* (date ('"qHis'yvStimeStamp) 十 


rand () ); 


| 


// 


ghijklmopgqrstuvwxyz0123456789'; 


getPackage 函 数 的 作用 是 生成 订单 详情 扩展 字符 串 。 在 商户 调用 JSAPI 时 ， 商 户 需要 确定 该 笔 订单 详情 ， 并 将 该 订单 详情 通过 一 定 的 方式 进 





















































































































































的 内 容 生成 预支 付 单 。 
/** 
大 
获取 扩展 包 
* Qparam type S$goodsDesc 
商品 描述 
* Qbaram type S$totalFee 
总 费用 
* Qreturn type 
7 
function getPackage ($goodsDesc, S$totalFee){ 
Sbanktype = "WX"; 
$fee type = "1";// 
费用 类 型 ， 这 里 1 
为 默认 的 人 民 币 
Sinput charset = "GBK";// 
a 
notify url = "http://www.qq.com";// 
支付 成 区 后 交 和 知 该 地址 
//Sout trade no = getANumber ();// 
订单 号 ， 商 户 需 要 保证 该 字段 对 于 本 商户 的 叭 性 
$out tragde no = 111; 
Spatt tner = PARTNER Li 
测试 商户 号 
$spbill create ip = $ SERVERI['REMOTE 




















?9 


这 个 值 和 以 上 其 


这 个 需要 在 前 
Spartner 





户 浏 览 器 的 IP 


端 获 取 。 








Key = PARTNE 














是 需要 商户 好 好 保存 的 。 


yf 














首 先 第 一 步 : 对 原 
进行 字典 

















岂 值 不 一 样 是 : 


串 进 行 签名 ， 


RKEY; 
人 


A 共 “一下 





工 7 
签名 需要 它 ， 而 最 后 





排序 拓 级 成 下 面 的 字符 十 


在 这 个 字符 串 最 后 拼接 上 key=XXXX 
。 由 于 这 里 的 字段 固定 ， 因 此 只 需要 按照 这 个 顺序 进行 排序 即 可 。 


$signString 





编码 。 


























二 步 ， 对 每 个 参数 进行 URL 








ADDR'] 











意 这 里 不 要 对 任何 字段 进行 





2 


编码 。 











Sbanktype = Urlencode ($banktype); 





$goodsDesc=urlencode (SgqoodqsDesc) 











S$fee 





Snoti 


type=urlencode ($f 
$input charset = urlencode ($input charset); 




















$out trade no = urlencode ($ou 


fy Url = urlencode ($notify : 
t trade no); 





ee type); 


y_url); 





tring)); 


这 里 


A 





组 成 的 传输 字符 串 不 能 含有 它 。 这 














= "bank type=" .Sbanktype."&bodqy=".S$gooqsDpesc."&fe 
smd5SignValue = strtoupper (md5 ($signs 


pn 
然后 第 二 


是 将 参数 按照 key=value 


个 key 


百 台 程序 来 写 入 JS API 的 参数 值 。 


行 组 合 放 入 package。JSAPI 调 用 后 ， 微 信 将 通过 

















type=" . $f 


ee type."&input charset=".$input charset ."&notif 





y_url=".S$notif 





这 里 用 PHP 来 实现 demo 中 的 


存在 。 


过 package 


y_ url."&out trade no=" .Sout trade no." 













































































Spartner = urlencode (Spartner) ， 
$spbill create ip = urlencode ($spbill create ip); 
$totalFee = urlencode ($totalFee); 时 
// 
然后 进行 最 后 一 步 ， 这 里 按照 key 
一 Value 
除了 sign 
外 进行 字典 序 排序 后 组 成 下 列 的 字符 串 ， 
最 后 再 串 接 sign=value 














$completesS 
$completesS 
return $completeString; 


} 




















getSignType 国 数 返回 签名 方式 ， 目 前 只 
/** 
大 
获取 微 信 签名 方式 SHA1l 
2 
function getSignType () { 
return "SHA17"， 


} 


getSign 函 数 用 来 生成 支付 签名 ， 只 有 通过 


获取 征 信 和 名 


* Qparam type S$ol 
随机 字符 串 
* Qparam 
扩 ， 展 包 
* Qparam 
时 间 堆 


Qreturn 
- 


dNonceSstr 





type S$ol 








type S$oldTimeStamp 





type 








$keyval 
return shal 


} 





($keyvaluestring); 


8.2.4 订单 查询 


在 JS API 提 示 支 付 成 功 后 


dPackageString 


function getSign($oldNonceStr, S$oldPackageString, S$ol 
uestring = "appidq=" .APPID 


，WeixinJSBridgeReady 会 返 











tring = "bank type=".$banktype."é&body=".$goodsDesc."&fee 
tring = $completeString . 


"&sign=".S$md5SignValue; 


4 支持 S HA1 o 


QITimeStamp) { 
GNK 














."&appkey=" .PAYS 





以 此 为 准 。 商 家 在 预期 时 间 内 收 不 到 最 终 支 付 通知 时 ， 也 可 以 用 此 接口 来 查询 结 


REY."&nNnoncestr=".$oldNoncestr. 


" 。 Sfe 





了 paySign 鉴 权 ， 才 能 继续 对 package 鉴 权 并 生成 预支 付 单 。 


订单 查询 API 的 URL 为 : https://api.weixin.qq.com/pay/orderquery?access token=XXXXXX。 


台 的 赁 


access token 是 微 信 公 众 平 














证 。 向 此 URL 以 POST 的 方式 提交 发 货 通知 的 数据 ， 即 可 获 和 








"appid": "wwwwb4f85f3a797777™, 
"Package": "out 2 
"timestamp": "1369745073"™, 


"app signature": 
"sign method": "shal" 


生成 postData 数 据 的 函数 代码 如 下 : 











/** 

大 
生成 用 于 查询 订单 的 json 
字符 串 

* Qparam String $appid 


$out trade no 




















第 三 方 唯一 订单 号 


9 
* Qparam String 
* Qparam String 


$appkey 


* Qparam String S$partner 
财 付 通 商户 身份 标识 

* QQparam String Spartnerkey 
财 付 通 商户 权限 密 钥 Key 


* Qparam String $timestamp 









































* Qreturn String 





trade no=11122&partner=1900090055&sign=4e8d0di 





"53cca9d47b883bd4a5c85a9300df3da0cb48565c"™, 











f3da0c3d0df38f", 





function genOrderQuery ($appid, Sout trade no,s$appkey, $partner, Spartnerkey $timestamp) { 








$sign = md5 ("out trade no={$out trade no}&partner={$partner} &key={$partnerkey}"); 
$app signature = - md5 ("appid={appid} &appkey={S$appkey} spackage={package} stimestamp={timestamp}"); 


$postArray = array ( 
'appid' => $appig, 
"Package 
'timestamp' => $ 
'app signature'" 
'sign method' => 








); 
return json encode ($spostArray); 


} 


校 验 成 功 后 ， 会 返回 数据 表明 是 


path=/open CS 


path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/..http://www.hzcourse.com/resource/readBook? 











=> "out trade no={$out trade no}l&partner={$partner}&sign={$sign}", 





timestamp, 
=> $app signature, 
"Shal”y 


通知 成 功 ， 例 如 : {"errcode":0， 


"errmsg":"ok", 


type."&input charset=".$input charset."&notif 


ee 但 是 ， 不 能 只 据 此 就 判断 支付 成 功 。 正 确 的 做 法 是 ， 收 到 返回 











y url=".$notify url."&out trade no=" .Sout traqe 


"&package=" .S$oldPackageString."&timestamp=".$oldTimeStamp; 


结果 后 ， 应 该 向 微 信 订 单 查询 API 查 询 结果 ， 并 


导 通 知 。 PostData 是 json 字 符 串 ， 如 下 代码 所 示 : 


http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/..}。 如 果 有 异常 ， 会 在 errcode 和 errmsg 描 述 出 来 ， 如 果 成 功 errcode 就 为 0。 如 果 查 询 成 功 ， 会 返回 详细 的 订单 数据 ， 可 依据 


此 数据 判断 是 否 支付 成 功 。 


8.3 ”短信 小 店 


2014 年 5 月 29 日 ， 微 信 公 


台 宣 布 正式 推出 “ 微 信 小 店 " 


。 无 须 编程 、 技 术 


“ 零 门 槛 ”的 电 商 接 入 模式 ， 使 服务 


[PA 
号 有 


快 i 


速 开 店 。 作 为 微 信 小 店 的 成 功 案 例 ， 印 美 图 微 信 小 店 在 6 天 内 突破 100 万 销 


售 ， 成 为 首 个 收入 破 百 万 的 微 信 小 店 。 基 于 品牌 在 社交 媒体 账号 中 打造 的 粉丝 效应 ， 是 微 信 小 店 成 功 的 关键 。 


开通 微 信 小 店 的 条 件 如 下 : 


. 通过 微 信 认证 


. 接 入 微 信 支付 


“ 按照 合同 约定 缴纳 一 定金 额 的 风险 保证 金 


满足 条 件 后 ， 商 家 可 以 在 服务 中 心 开通 微 信 小 店 ， 如 图 8-8 所 示 。 






徽 信 小 店 下 
微 信 小 店 基于 微 信 支付 ， 包 括 添 加 商品 、 商 品 管理 、 订 单 管理 、 货 架 管理 、 维 权 等 功能 , 开 详情 > 
发 者 可 使 用 接口 批量 添加 商品 ， 快 速 开 店 。 














点 击 详情 ， 进 入 微 信 小 店 的 开通 页 面 。 如 果 已 经 满足 条 件 ， 请 点 击 “ 申 请 ”， 如 图 8-9 所 示 。 


开通 后 ， 商 家 即 可 使 用 添加 商品 、 商 品 管理 、 订 单 管 理 、 货 架 管理 、 维 权 等 功能 。 


开店 五 步 
微 信 小 店 的 管理 十 分 便捷 ， 通 过 以 下 五 个 步骤 就 可 完成 微 信 开 店 。 
1 第 一 步 : 添加 商品 


1) 选择 类 目 。 在 如 图 8-10 所 示 的 界面 选择 类 目 。 


2) 然后 再 按照 指引 填写 商品 的 基本 信息 ， 包 括 商品 名 称 、 商 品 图 片 、 运 费 、 库 存 、 详 情 摘 述 等 。 


微 信 小 店 … 


时) 介绍 
9 。 微 信 小 店 基于 微 信 支付 ， 和 包括 添加 商品 、 商 品 管理 、 订 单 管理 、 货 架 管理 、 维 权 等 功能 ， 开发 者 可 使 用 接口 批量 
添加 商品 ， 快 速 开 店 . 
。 开通 后 ， 你 可 以 在 微 信 小 店 中 进行 小 店 的 开启 、 运 营 和 使 用 . 
。 普通 用 户 可 直接 通过 小 店 功 能 管理 小 店 ， 开 发 者 则 可 以 通过 开发 接口 来 实现 更 灵活 的 小 店 运营 . 


和 声明 


* 必 各 先 开 通商 户 功能 后 ， 才 可 申请 开通 微 信 小 店 

* 徽 信 小 店 只 可 用 于 售卖 肘 选 的 徽 信 支付 经 营 泡 围 之 内 的 商品 

s 你 在 使 用 微 信 小 店 过 程 中 ， 必 须 同 时 道 守 微 信 公 众 帐 号 以 及 商户 功能 相关 的 各 项 协议 、 规 则 ,包括 但 不 限于 遵守 
入 信和 公众 平台 服务 协议 、 《向 信和 电子 商务 服务 协议 jl 以 及 你 与 腾讯 签 团 的 《 微 信 公众 和 平台 商户 功能 服务 协议 
》《 纸 质 ) 等 内 容 . 

















































































































2. 第 二 步 : 商品 管理 


1) 商品 分 组 管理 : 可 以 设置 不 同 的 分 组 来 管理 商品 ， 分 组 可 用 于 将 商品 填充 到 货架 中 ， 如 图 8-12 所 示 。 


2) 商品 上 下 架 : 可 以 快速 对 商品 进行 上 下 架 操 作 ， 如 图 8-13 所 示 。 


3. 第 三 步 : 货架 管理 


1) 货架 的 定义 : 商家 用 于 承载 商品 的 模板 ， 每 一 个 货架 是 由 不 同 的 控件 组 成 的 ， 如 图 8-14 所 示 。 


商品 分 组 ”大 不 设置 ”四 设置 
照片 图 库 ”大 不 设置 ”二 设置 


本 地 上 传 图 片 大 小 不 能 超过 500k 





本 类 目下 最 多 可 以 上 传 5 张 图 片 





商品 属性 ” 电 不 设置 。@ 设置 











时 尚 纯色 修身 
颜色 : 和 白色 ¥6544.00 56656 0 0 







[| 呈 king 的 测试 商品 _ 美 甲 贴纸 ¥0.01 0 king 组 = 


= 








图 8-12 








图 8-13 


Fe pe 本 省 
店 请 名 标 





以 商品 直接 展示 为 主 ， 风格 均衡 、 协 调 的 沉 深 模板 一 张大 图 作为 背景 , 注重 品牌 建设 和 宣传 的 省 敌 模板 





图 8-14 


2) 选择 完 货 架 之 后 ， 商 家 可 以 将 分 组 管理 里 面 的 商品 添加 到 货架 中 ， 如 图 8-15 所 示 。 





图 8-15 


3) 发 布 货架 。 将 编辑 好 的 货架 发 布 ， 然 后 复制 链接 ， 链 接 可 以 填 入 自 定 义 菜单 中 ， 或 者 下 发 到 商品 消息 中 ， 如 图 8-16 所 示 。 


4. 第 四 步 : 小 店 概况 


可 以 查看 小 店 所 有 的 数据 信息 : 订单 数 、 成 交 量 等 ( 见 图 8-17) 。 


5. 第 五 步 : 订单 管理 


用 户 支 付 成 功 会 生成 一 笔 订单 ， 商 家 可 以 查询 订单 ， 并 进行 发 货 等 操作 ， 如 图 8-18 所 示 。 





Demo Special 





图 8-16 


36 


待 故人 订单 








订单 煞 | 成亲 向 品 数 /总 向 品 数 ] 成 变 略 
9 lb6/164 0.26 
商品 浏览 量 吧 此 总 浏 览 量 司 ] 商铺 访问 人 数 


20 18 20 


图 8-17 


下 单 时 间 东 近 /日 东 近 1 日 东 ir20 日 | 201403-10 主 2014-04-08 





8.4 多 客服 功能 
伴随 着 微 信 小 店 而 来 的 ， 是 微 信 公众 平台 的 多 客服 功能 。 有 过 购物 经 验 的 读者 都 知道 ， 在 下 单 前 可 以 跟 客 服 M M 聊 几 句 ， 说 不 定 就 能 免 运 费 或 获取 一 些 优惠 ， 即 使 没有 优惠 ， 听 几 名 杀 切 的 “ 亲 ” 也 是 


不 错 的 。 如 果 在 微 信 上 开店 ， 业 务 量 大 时 一 个 客服 不 够 应 对 ， 就 需要 开通 多 客服 功能 。 微 信 开 通 了 多 客服 功能 ， 而 且 开 放 了 接口 ， 有 条 件 的 商家 可 以 实现 自己 需要 的 功能 。 


8.4.1 服务 开通 


微 信 认 证 的 服务 号 可 在 “服务 中 心 ” 中 申请 开通 多 客服 功能 ， 如 图 8-19 所 示 。 








OF i 支持 多 人 同时 为 一 个 公众 号 提供 客服 服务 。 详情 > 


图 8-19 


点 击 “详情 ”， 进 入 多 客服 的 开通 页 面 ， 如 图 8-20 所 示 。 注 意 声 明 部 分 ， 请 勿 给 用 户 发 送 垃圾 广告 和 营销 信息 ， 违 反 的 后 果 很 严重 。 可 参考 微 信 “清理 集 赞 行为 ”的 公告 。 











国 介绍 


* 多 宕 服 为 公众 瑟 提 供 客服 功 庄 ,去 持 多 人 同时 为 一 个 公信 号 提供 寡 乳 服务。 
es 天 请 后 , 可 在 功能 中 进行 相应 的 本 次 . 


声明 
4 请 相 氮 十 述 零 求 屠 用 多 客 眠 ,天 则 将 会 受 惠 右 三 . 
sa 窗 寄 服 功 能 仅 供 会 其 号 回答 害 户 咨询 并 进行 相应 服务 。 
se 请 和 如 使 用 守 音 服 功 有 紫 友 送 垃 声 广 告 或 后 成 又 要 , 
es 请 各 使 用 襟 客 服 内 能 故 送 营 适 兴 消 自 . 


在 绪 害 服 | 容 服 中 心 





图 8-20 
8.4.2 添加 客服 工 号 


商户 在 微 信 公众 平台 开通 人 工 客 服 权 限 以 后 ， 在 “功能 -多 客服 ”页 面 中 ， 可 添加 客服 工 号 ， 如 图 8-21 所 示 。 


多 客服 客户 师 


使 用 季 寿 服 ， 您 可 以 字 个 寿 服 账号 同时 服务 一 个 公众 号 ， 轻松 解 决 您 的 罕 服 问题 ,不 错过 任何 一 个 服务 机 会 。 若 您 具备 开发 能 
力 ， 还 可 通过 客户 端 高 级 设置 ， 添加 丰富 的 自 走 义 揪 件 ， 让 多 客服 与 您 自身 的 业务 系统 紧密 对 接 





你 尚未 添加 任何 客服 ， 立 刻 添 加 





图 8-21 


点 击 “ 添 加 客服 工 号 ”， 可 以 在 弹出 的 窗口 中 填写 客服 工 号 信息 ， 如 图 8-22 所 示 。 








图 8-22 


8.4.3 ”在 电脑 上 使 用 多 客服 


微 信 提供 了 多 客服 软件 ， 商 家 可 以 下 载 安 装 使 用 ， 下 载 地 址 为 : http://crm.mp.weixin.qq.com/cgi-bin/dkf_download url。 
下 载 后 ， 打 开 “ 多 客服 ”软件 的 安装 向 导 ， 请 根据 提示 完成 安装 ， 如 图 8-23 所 示 。 
完成 安装 后 ， 运 行 时 会 弹出 登录 框 。 用 上 一 节 添 加 的 客服 工 号 和 密码 登录 系统 ， 如 图 8-24 所 示 。 


这 样 就 能 在 电脑 上 收 到 客户 消息 并 进行 回复 了 ( 见 图 8-25) 。 


多 客服 4.2 安装 - 口 本 至 
欢迎 使 用 “多 客服 4. 2” 安 装 向 导 





同 导 将 指引 你 完成 “多 窜 服 4.2” 的 安装 进程 。 
和 


单 击 [下 一 步 (WD] 继续 。 


多 客服 


dkf.qq.com 














多 各 服 


dkf.ag,com 








客户 新 消息 提示 





[1 源 自 : 多 客服 官网 (http://dkfqdq.comy) 


8.4.4 在 微 信 上 使 用 多 客服 


在 微 信 上 使 用 多 客服 ， 首 先 要 关注 公众 号 “多 客服 助手 ” (duokefu) 。 


多 客服 助手 的 自 定 义 菜 单 如 图 8-26 所 示 ， 点 击 “ 账 号 ”来 绑 定 工 号 。 


在 跳 转 的 页 面 上 输入 工 号 和 密码 ， 即 可 实现 工 号 绑 定 ( 见 图 8-27) 。 





图 8-20 





图 8-27 


当 用 户 发 来 消息 时 ， 客 服 账 号 会 接收 到 消息 通知 ， 如 图 8-28 所 示 。 


下 午 8:36 : i 中 国联 通 邱 下 年 444 全 ， 中 国联 通 室 。 ”下 午 8:41 


多 客服 助手 返回 通话 记录 & 返 多 客服 助手 


新 消息 通知 


en te Pe eR | Bp. = Ey 
i 居于 sb i | he _ 


和 总 于 目 ; 小 @@ 关闭 自动 接 人 
LH: 2014-04-28 20:.23-:28 


拉 拉 啦 


来 自 ， 本 小 站 | FE 
RR 送 了 时 间 : 2014-04-28 20:30:35 





图 8-28 山 


[1 源 自 : 多 客服 官网 (http://dkf.qq.com/) 


8.5 ”本 章 小 结 


本 章 围绕 “ 微 商 城 ” 介 绍 了 微 信 移 动 场景 下 的 电 商 相关 的 开发 ， 包 括 完 整 的 抽奖 系统 的 设计 与 实现 ， 微 信 支 付 的 实现 、 微 信 小 店 及 多 客服 功能 。 本 章 用 到 了 微 信 的 网 页 授权 获取 用 户 openid， 微 信 
WeixinJSBridge， 微 信 JS AP 上 与 订单 查询 API， 并 介绍 了 微 信 小 店 和 多 客服 的 开通 、 使 用 方法 ， 希 望 对 想 进 军 移动 电 商 的 读者 有 所 帮助 。 


第 9 和 章 “” 微 酒店 


对 于 商家 来 说， 如 何 让 自己 更 直接 地 到 达 用 户 是 成 功 的 关键 ， 酒 香 还 怕 巷 子 深 ， 所 以 酒店 把 招牌 做 得 绚丽 ， 显 眼 是 过 去 乃至 未 来 商家 的 必然 选择 ， 但 招牌 能 影响 的 范围 毕竟 有 限 ， 尤 其 现在 交通 方便 ， 
酒店 距离 远 点 其 实 问题 也 不 是 很 大 。 所 以 ， 让 酒店 信息 更 直接 ， 实 时 地 直达 用 户 ， 更 贴心 地 服务 用 户 会 对 用 户 形成 很 大 的 吸引 力 。 移 动 互联 网 的 兴起 给 传统 商家 的 宣传 提供 了 更 便捷 的 工具 ， 让 客户 能 随时 
了 解 酒店 信息 和 服务 。 


将 微 信 公众 号 与 酒店 CRM 后 台 链 接 ， 可 以 方便 地 实现 房间 预订 ， 订 单 管理 等 功能 。 这 比 传统 的 打 电 话 预订 ， 更 方便 ， 更 节省 人 力 。 对 用 户 来 说 ， 通 过 公众 号 对 酒店 首先 有 了 直观 的 印象 ， 能 提高 用 户 体 
验 。 与 电话 预订 相 比 ， 我 想 大 部 分 人 更 倾向 于 在 线 预 订 。 微 信 公 众 号 还 能 更 好 地 实现 活动 推广 、 客 户 管 理 等 功能 ， 比 单纯 一 张 会 员 卡 好 了 无 数 倍 ， 没 人 喜欢 带 着 一 皮 夹 各 种 会 员 卡 出 门 ， 将 会 员 卡 内 置 在 公 
众 号 的 会 员 管 理 中 就 方便 多 了 。 


9.1 微 酒店 功能 及 设计 
9.1.1 功能 


微 酒店 通过 与 酒店 CRM 后 台 打通 ， 可 以 实现 很 多 人 性 化 的 功能 ， 这 里 我 们 提供 几 个 最 重要 的 功能 : 预订 酒店 、 订 单 管理 及 会 员 卡 〈 见 图 9-1) 。 预 订 酒店 是 通过 微 信 提供 的 定位 接口 (自动 发 送 位 置信 
息 和 手动 发 送 位 置 ) 给 用 户 找 出 最 近 的 几 家 店 ; 订单 管理 让 用 户 能 浏览 未 完成 的 订单 ， 还 可 进行 删除 订单 等 操作 ; 会 员 卡 展示 会 员 及 积分 信息 。 


secoo 中 国联 通 全 下 午 6:54 夸 


< 订 问 号 ” 微 信 公 灰 平台 曾 .. 





IY ， 欢 迎 来 到 纳 吉 酒店 ， 
注册 用 户 第 一 次 使 用 微 信 
预定 ， 在 原 有 折扣 基础 之 
上 再 减 20 元 ， EE 以 抵 
hh ， 来 吧 





de 


Ed 我 订 酒 店 


微 酒店 也 可 以 利用 百度 地 图 等 地 图 API 实 现 POI 标 注 及 导航 功能 ， 这 些 知识 在 前 面 的 章节 介绍 过 了 ， 这 里 不 再 袭 述 。 


9.1 微 酒店 功能 及 设计 
9.1.1 功能 


微 酒店 通过 与 酒店 CRM 后 台 打通 ， 可 以 实现 很 多 人 性 化 的 功能 ， 这 里 我 们 提供 几 个 最 重要 的 功能 : 预订 酒店 、 订 单 管理 及 会 员 卡 〈 见 图 9-1) 。 预 订 酒店 是 通过 微 信 提供 的 定位 接口 (自动 发 送 位 置信 
息 和 手动 发 送 位 置 ) 给 用 户 找 出 最 近 的 几 家 店 ; 订单 管理 让 用 户 能 浏览 未 完成 的 订单 ， 还 可 进行 删除 订单 等 操作 ; 会 员 卡 展示 会 员 及 积分 信息 。 


secoo 中 国联 通 全 下 午 6:54 夸 


< 订 问 号 ” 微 信 公 灰 平台 曾 .. 





IY ， 欢 迎 来 到 纳 吉 酒店 ， 
注册 用 户 第 一 次 使 用 微 信 
预定 ， 在 原 有 折扣 基础 之 
上 再 减 20 元 ， EE 以 抵 
hh ， 来 吧 





de 


Ed 我 订 酒 店 


微 酒 店 也 可 以 利用 百度 地 图 等 地 图 API 实 现 POI 标 注 及 导航 功能 ， 


9.1.2 ”数据 库 设 计 


数据 库 设 计 见 表 9-1 至 表 9-4。 


字 段 名 
Id 
Name 
Address 
Latitude 
Longltude 
Clty 
PicUrl 


Telephone 


Id 
Roomld 
Time 
Openld 
Price 
Count 
Total 
Finished 


FirstOrder 


Type 
Price 
Hotelld 


MemberPrice 


这 些 知识 在 前 面 的 章节 介绍 过 了 ， 这 里 不 再 歼 述 。 


表 9-1 Bh_HotelInfo 
字段 类 型 
int(11) 
varchar(50) 
varchar(200) 
double 
double 
varchar(20) 
varchar(200) 
varchar( 12) 
表 9-2 Bh_Order 
字段 类 型 
int(11) 
Int(11) 
Date 
Varchar(100) 
Int(11) 
Int(11) 
Int(11) 
tinyint(1) 
tinyint(1) 
表 9-3 ”Bh_Room 
字段 类 型 
int(11) 
Varchar(20) 
Int(11) 


Int(11) 
Int(11) 


表 9-4 Bh_User 


酒店 Id， 
酒店 名 
酒店 地 址 
酒店 纬度 
订 1) 


一 


= 


经 度 
所 在 城市 


图 片 URL 
酒 | ji i 电话 


字段 描述 


主键 ， 目 增长 


， 显 示 在 图 文 消 上 县 上 


字段 描述 


订单 Id4， 主 键 ， 目 增长 


房间 号 


1 


撰 订 日 期 


用 户 晶 


Openld 


房间 价格 


天 数 


订单 是 否 完 成 


是 否 是 第 一 个 订单 


字段 描述 
房间 14， 主 刍 ， 日 增长 


房间 类 型 


价格 
酒店 Id4， 该 房间 所 在 酒店 
会 员 价 


Id 

Type 
Openld 
Telephone 
Name 
Identity 
Credits 
Latitude 
Longitude 
City 


LocTime 


9.2 功能 实现 


本 章节 代码 放置 在 BookHotel 目 录 下 ， 样 式 表 文件 放 在 CSS 目 录 下 ，JavaScript 文 件 放 在 JS 目 录 下 。Bookhotel.php 文 件 定 义 了 Bookhotel 类 ， 该 类 继承 自 weixin 类 ，weixin 类 在 接口 部 


字段 类 型 
int(11) 


Varchar(20) 


Varchar(100) 


Varchar(11) 
Varchar(20) 
Varchar(20) 
Int(11) 
Double 
Double 
Varchar(100) 


datetime 


装 了 与 微 信 交互 的 所 有 接口 ， 包 括 获取 token， 发 送 各 种 类 型 消息 等 。 其 他 文件 都 将 在 本 节 后 续 介 绍 。 
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设置 了 两 种 类 型 的 按钮 ， 


目 定 义 荣 单 


用 尸 的 OpenId 
用 已 号 介 

用 户 姓 名 

用 户 号 份 证 


最 新 一 次 定位 的 纬度 


最 新 一 次 定位 的 经 度 


了 


最 新 一 次 定位 的 城市 


下 


最 新 一 次 定位 的 时 间 


分 介绍 过 ， 它 封 


“ 订 酒店 ”是 click 类 型 的 ，“ 我 ”菜单 下 的 二 级 菜单 是 view 类 型 。view 类 型 菜单 直接 跳 转 网 页 但 无 法 获取 用 户 信息 ， 前 面 接口 部 分 介绍 过 微 信 提 供 了 OAuth2.0 认 证 ， 通 过 认 


证 后 ， 用 户 可 以 获取 用 户 openid 以 及 更 多 的 个 人 信息 ， 这 个 方案 有 个 不 好 的 地 方 是 需要 用 户 手 动 点 击 一 个 认证 链接 ， 这 种 体验 不 是 很 友好 。 所 以 我 们 使 用 了 一 个 折 中 的 方案 ， 将 view 类 型 的 URL 设 成 验证 链 
接 ， 原 先 准 备 设置 的 链接 作为 验证 链接 的 跳 转 链接 。 这 种 方案 的 好 处 是 用 户 体验 比较 好 ， 无 须 验 证 链接 ， 坏 处 是 每 次 都 需要 通过 跳 转 到 达 目 标 页 面 ， 多 了 一 步 操作 ， 性 能 上 有 损失 。 从 使 用 效果 来 看 ， 这 种 


方案 是 值得 的 。 自 定义 菜单 的 实现 代码 如 下 : 








{ 





smenu = '{ "button":T[ 
{ 
"name™":" 
"sub putton": [ 
{ 
"七 Ype" : "Viewn 
"name":" 
我 的 订单 "， 
"url":"https 
}, 
{ 
"type":"view" 
"name™":" 
我 的 会 员 卡 "， 
"varl™: "httpos 
}, 
{ 
"type":"view" 
"name™":" 
抵 用 券 "， 
}] 
}, 
{ 
"type":"click", 
"name™":" 
订 酒 店 "， 


function CreateNewMenu () 








$myorderurl = urlencode ("http://8.huoyaxiaotu.sinaapp.com/BookHotel/MyOrder .php"); 





"url":"https://open.weixin.ggq.com/connect/oauth2/authorize?appid=wxe434ef 


Wyma 


bs 





$ret = self::createMenu (Smenu) ， 





$this->outputText ($ret); 


了 


://open.weixin.gqq.com/connect/oauth2/authorize?appid=wxe434ef 


了 


://open.weixin.gqq.com/connect/oauth2/authorize?appid=wxe434e 


r 


























44d6810eleg&redirect uri=http%3A%$2F%2F8.huoyaxiaotu.sinaapp.coms2F] 


44d681l0eleg&redirect uri=http%$3A%2F%$2F8.huoyaxiaotu.sinaapp.com%s2F 


£44d6810eleg&redirect uri=http%$3A%$2F%2F8.huoyaxiaotu.sinaapp.coms2F 








BookHotel%$2FMyC 





BookHotel%$2FMyN 


BookHotel%$2FMyCoupc 
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消息 处 理 


这 里 为 了 方便 ， 微 商店 只 处 理 点 击 菜单 事件 消息 、 位 置 消息 、 订 阅 事件 消息 及 位 置 事件 消息 ， 其 他 类 型 的 消息 将 返回 提示 消息 。 具 体 代码 如 下 : 





/** 


大 
判断 用 户 消息 及 事 
*/ 





痘 


function ProcessMessage ($data) 


// 





> 十 


I 果 用 户 发 送 的 是 文本 数据 
if (S$this->isTextMsg()) { 
$sthis->outputText (" 
请 点 击 菜单 ， 完 成 你 的 需求 哦 ") ; 


] 果 用 户 发 送 的 是 地 理 位 置 数据 
elseif (S$this->isLocationMsg()) {{ 
$this->saveLocation ($data->Location X,s$data->Location Y,s$data-> 
FromUserName, $data->Label); 
$list = S$this->queryHotelByCoordinate ($data->FromUserName); 
$sthis->sendHotelListNews ($data, $list 
}elseif (S$this->isEventMsg()) { 
$sthis->checkEvent ($data); 
}elsel{ 
$sthis->outputText (" 
请 点 击 菜单 ， 完 成 你 的 需求 哦 ") ; 
} 
} 
private function checkEvent ($data) 


{ 





























尘 



































~ 一 


党 


~ 一 





























f(Sthis->isSubscribeEvent () ) 


一 PP- 





S$this->outputText (" 
叫 ， 欢 迎 来 到 纳 吉 酒店 ， 注 册 用 户 第 一 次 使 用 微 信 预订 ， 在 原 有 折扣 基础 之 上 再 减 20 


ry 
职 分 还 可 以 抵 扣 房 费 ， 还 等 什么 ， 来 吧 ! 11 
么 么 隐 ~") ; 

} 

elseif ($this->isLocaitonEvent () ) 


{ 



























































4 


this->saveLocation ($data->Latitude, $data->Longitude, $data-> 
FromUserName); 
} 
elseif ($this->isClickEvent () ) 








f ($data->EventKey == 'V2001') 


一 PP- 








$list = S$this->queryHotelByCoordinate ($data->FromUserName); 
$sthis->sendHotelListNews ($data, $1ist); 





9.2.3 ”位 置 消息 


微 信 中 分 享 位 置 有 两 种 方法 : 在 输入 框 中 发 送 位 置 ; 用 户 同意 自动 发 送 位 置信 息 后 ， 微 信 自动 帮 送 位 置 给 公众 号 后 台 。 对 于 第 一 种 情况 ， 我 们 认为 自动 触发 查找 附近 酒店 的 命令 ， 即 相当 于 点 击 了 “ 订 
酒店 ”菜单 ;对 于 第 二 种 情况 ， 我 们 只 需 把 用 户 的 位 置信 息 保存 下 来 ， 等 未 来 用 户 点 击 “ 订 酒店 ”按钮 ， 我 们 就 能 根据 用 户 最 新 的 位 置 为 用 户 找 到 附近 的 酒店 。 


需要 注意 的 是 位 置 消 息 的 经 纬度 标记 分 别 是 Location_X 和 Location Y， 而 位 置 事件 则 是 Latitude，Longitude， 而 且 位 置 事 件 不 提供 地 址 消息 。 


SaveLocation 首 先 判 断 用 户 是 否 在 数据 库 中 ， 如 果 没 有 则 加 入 数据 库 中 ， 将 用 户 保存 到 bh_user 表 中 。 如 果 地 址 信息 不 为 空 ， 则 调用 extractCityFromLabel 尝 试 从 中 提取 城市 消息 。 将 经 纬度 ， 更 新 时 
间 及 城市 消息 存 入 数据 库 中 。 具 体 代码 如 下 : 


/** 
大 


保存 地 理 位 置 
大 
private function saveLocation($Latitude,s$Longitude,$openid,$Label=null]l) 


{ 

















Sthis->saveUser ($openid); 

smysql = new SaeMysql () ， 

5sql = "update bh User set Latitude = $Latitude, Longitude =$Longitude,"; 
if 

{ 








f(!is null ($Label)) 








Scity = S$this->extractCityFromLabel ($Label); 
Ssals= "City="Seity' ,sy 








$sql.= "LocTime =NOW() where ‘OpenId'="'$openid"'™"; 
smysql->runSql ($sql); 

if ($mysql->errno() != 0) 

{ 











die ("Error:".S$mysql->errmsg () ); 


} 
smysql->closeDb () ， 
} 
private function saveUser (Sopenid) 
{ 
smysql = new SaeMysql (); 








$sql = "select count (*) from bh User where OpenId="'$openid'",; 
SExist=$mysql->getVar ($sql); 
if ($Exist == 0) 
{ 
$sql = "insert into bh User (OpenId) values('$openid')"; 








$mysql->runSql ($sql); 








if ($mysql->errno() != 0) 
{ 


} 
smysql->closeDb () ; 





die ("EFrror:".S$mysdql->ertrmsd() ) ; 


} 
/** 


大 
从 地 理 位 置 中 提取 出 城市 名 
4 
private function extractCityFromLabel ($l1abel) 
{ 








$pos1 strpos ($label, " 

















$pos2 = strpos ($label, " 





return mb substr ($label, S$posl, $pos2-$posl1); 


9.2.4 ”附近 酒店 


当 用 户 点 击 “ 订 酒店 ”菜单 或 者 发 送 位 置信 息 ， 微 酒店 根据 用 户 位 置 计算 查找 附近 的 分 店 。queryHotelByCoordinate 首 先 判断 位 置 消息 是 否 陈旧 ， 默 认 设置 最 近 5 分 钟 没 更 新 的 位 置信 息 不 可 用 ， 需 
重新 提供 。 然 后 查找 分 店 信息 ， 如 果 有 城市 消息 ， 提 供 该 城市 的 分 店 消息 ， 如 果 没 有 则 提供 所 有 分 店 消息 。 对 每 家 分 店 调用 getDistance 计 算 与 当前 位 置 的 距离 。 最 后 根据 位 置 对 分 店 排序 。 具 体 代码 如 下 : 


/** 


en 


private function queryHotelByCoordinate ($openig) 

















Smysaql = new SaeMysal () ， 

$sql = "select * from bh User where OpenIq ='Sopenidq' "7 

Suserinfo = $mysql->getLine ($sql); 

$sdiffseconds = strtotime (date("Y-m-d H:i:s"))-strtotime( ($userinfo["LocTime"])); 
if($diffseconds > 300) 
{ 

















Sthis->outputText (" 
无 法 获取 你 的 位 置 、 诊 训 宙 全 下 明 的 六 入 图 表 ， 并 允许 \" 
提供 位 置信 息 \" 


和 六 以 手动 必 这 人 入 直 询 ; 



































a = new SaeMysql () ; 
$sql = "select * from bh HotelInfo"; 
if(!is null ($userinfo["City"])) 


{ 








Scity =$userinfol"City"]; 
$sql.=" where City ="'S$city'"; 








} 
$Shotellist=$mysql->getData ($sql); 
if ($mysql->errno() != 0) 

{ 


die ("Error:".$mysgql->errmsg () ); 
} 
smysql->closeDb (); 
$list = array(); 
foreach (Shotellist as S$hotel) 





$dis = S$this->getDistance ($hotel["Latitude"],$hotel["Longitude"], $userinfo["Latitude"], $userinfo["Longitude"]); 
$ hotel = array( 
"Id"=>$hotel["Id"], 
"Name"=>$hotel ["Name"], 
"Distance"=>$dis, 
"PicUr1"=>$hotel ["PicUr1"] 
); 
$list[] = $ hotel; 














} 
ksort ($list,"Distance"); 
return S$list; 








} 


/** 
* Qdesc 


根据 两 点 间 的 经 纬度 计算 距离 























Qparam float $lat 
纬度 值 
* Qparam float $lng 
经 度 值 
* QQreturn 
单位 m 








function getDistance ($latl, $lngl, $lat2, $1lng2) 





// 
地 球 半 径 近 似 值 
SearthRadius = 6367000; 









































$latl = ($latl * pi() ) / 180; 
$lngl = ($lngl * pi() ) / 180; 
$lat2 = ($lat2 * pi() ) / 180; 
$1lng2 = ($lng2 * pi() ) / 180; 





$calcLongitude = $lng2 -$lngl; 

$calcLatitude = $lat2 -$latl; 

$stepOne = pow (sin($calcLatitude / 2), 2) + cos ($lLat1) * cos($lat2) * pow(sin($calcLongitude / 2), 2); S$stepTwo = 2 * asin(min(1, sqrt($stepOne))); 
$calculatedDistance = SearthRadius * $stepTwo; 

return round($calculatedDistance); 


























将 酒店 预订 页 面 通过 图 文 消息 发 送 给 用 户 。 当 用 户 点 击 图 文 消 息 ， 就 会 打开 hoteldetail.php 页 面 ， 通 过 GET 方 式 传递 了 hotelid 和 openid 信 息 。 






































/** 
大 
发 送 酒店 列表 图 文 消息 
*7 
private function sendHotelListNews ($data, $1ist) 
{ 
snewslist = array(); 
foreach ($list as S$hotel) { 
PSE = arrayl( 
'title' => S$hotel["Name"]."\n 
距离 ".number format ($hotel["Distance"] /1000,2)." 
公里 "， 
'description' => " "7 
'picurl' => Shotel["PicUrl"], 
'url' => 'http://8.huoyaxiaotu.sinaapp.com/BookHotel/hoteldetail.php?hoteligd="'.$hotel["Id"].'&openigd="' .$data->FromUserName 
snewslist[] = $news; 
} 
// outputNews 
用 来 返回 图 文 信息 
$xml = Sthis->outputNews ($newslist); 





} 





图 文 消 息 如 图 9-2 所 示 ， 点 开 第 一 项 如 图 9-3 所 示 : 


TTTT 中 国联 通 会 下 午 10:2( 7 289% 


EA = 









































纳 吉 酒 店 月 亮 湾 店 
距 高 0.45 公 里 








纳 吉 酒店 湖 东 店 
距离 6.05 公 里 


纳 言 酒店 左 证 店 
距离 7.39 公 里 


吉 酒 店 观 前 街 店 
距离 10.85 公 “里 





-一 二 氢 tJ 酒店 


图 9-2 ”图 文 消息 


*see 中 国联 通 写 下午 10:22 久 了 站 88% 本 到 ) 


《返回 微 信 公众 平台 测试 号 。…* 




















地 址 : 苏州 市 工业 园区 星湖 街 168 号 
电话 : 051285364566 





人 . 住 日 期 : 




















门市 价 会 员 价 
大 订房 A 179 169 











9.2.5 “预订 酒店 页 面 


预订 酒店 页 面 的 具体 实现 代码 如 下 所 示 : 






























































































































































































































































































































































































































































































































































































































































































































































ui.js"></script> 


fix"> 




































































t/../images/ 
t/../images/ 


./images/ 


./images/ 
./images/ 
./images/ 


fu 


ful 了 


t/../CSS/jquery.ui.all.css"> 

tyles.css" type="text/css" rel="stylesheet"™" /> 
t/../CSS/photoswipe.css" type="text/css" rel="stylesheet 
t/../Js/simple-inheritance.min.] 
t/../Js/code-photoswipe-1.0.11.n 
ui .core.js"></script> 

.js"></script> 

ui .datepicker. js"></script> 
BPS/Text/../CSS/jquery-ui.css"> 








/1.jpg"><img src= 














ful 了 
11/3.jpg"><img src=" 








fu 本 


fu 二 
1/5.jpg"><img src=" 











ful 了 








1 <?php 
2 Smysal = new SaeMysal () ， 
3 $hotelid=intval ($ GETI["hotelid"]); 
4 $openid=$mysql->escape ($ GET['openid']); 
5 $sql = "select Name from ‘bh User where ‘OpenId ="'$openid'"; 
6 SName=$mysql->getVar ($sql); 
4 if (is null (SName)) 
8 { 
9 if ($mysql->errno() != 0) 
10 { 
11 die ("Error:".smysql->errmsg () ); 
12 } 
13 smysql->closeDb () ， 
14 header ('Location:http://8.huoyaxiaotu.sinaapp.com/BookHotel/BindUser.php?hotelid=" .S$hotelid.'&openid="'.$openid); 
Ts exit (0); 
16 } 
oe $sql = "select * from bh Room where HotellId =$hotelid"; 
18 $rooms= ysals roe Data te a) 
19 $sql = "select * from bh HotelInfo where Id =$hotelid"; 
20 $Shotel =$mysql->getLine ($sql); 
21 if ($mysql->errno() != 0) 
22 { 
23 die ("Error:".s$mysql->errmsg () ) 
24 } 
29 smysql->closeDb (); 
26 ?> 
27 <1DOCTYPE HTML> 
之 8 <html> 
29 <head> 
30 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
31 <meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
32 <meta name="format-detection" content="telephone=no" /> 
33 <meta name="apple-mobile-web-app-capable" content="yes" /> 
34 <title> 
纳 吉 酒店 </title> 
35 <link rel="stylesheet" href="nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 
36 <link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/../CSS/si 
37 <link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Texi 
38 <script type="text/javascript" src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 
39 <script type="text/javascript" src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 
40 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/../Js/jquery. 
41 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../Js/jquery.ui.widget 
42 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/../Js/jquery. 
43 <link rel="stylesheet" href="nhnttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0E 
44 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery-1.10.2.js"></script> 
45 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/../Js/jquery- 
46 <script> 
47 $ (function() { 
48 $( "#datepicker" ) .datepicker (); 
49 var date = (new Date() .getMonth()+1)+"/"+new Date () .getDate()+"/"+new Date () .getFullYear(); 
50 $( "#datepicker™" ) .val (date); 
31 }); 
52 // Set up PhotoSwipe with all anchor tags in the Gallery container 
53 document .addEventListener('DOMContentLoaded', function()f{ 
54 Code.photoSwipe('a', '#Gallery'); 
55 }, false); 
56 </script> 
5 <style> 
58 .Contentt{ 
359 border:2px solid #d9d9g9; 
60 border-radius: 15px; 
61 } 
62 </style> 
63 </head> 
64 <body> 
65 <div class="d-left-module mt1l5"><div class="inner m-hotel-overview" id="jxDescTab"> 
66 <h2 class="facility-title"><?php echo S$hotel["Name"];?></h2><div class="hotel-introduce" id="descContent"><div class="base-info bordertop cir 
67 <dl class="inform-list"><dt> 
地 址 : </dt><dg><cite><?php echo $hotel["Agddress"];?></cite></dd></d1> 
68 <dl class="inform-list"><dt> 
电话 : </dt><dqd><cite><a href="tel:<?php echo Shotel ["Telephone"] ; ?>"><?phpb echo S$hotel["Telephone"];?></a></cite></dd></dl1> 
69 <br/> 
70 <div 1q="Ga] lery"> 
eal <div class="gallery-row"> 
72 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 
73 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text 
74 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressedq/14881/OEBPSVText/ . 
19 </div> 
76 <div class="gallery-row"> 
77 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/. 
78 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/. 
79 <div class="gallery-item"><a href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0OEBPS/Text/. 
80 </div> 加 
81 </div> 
82 <pbr/> 
83 <form action='AddOrder.php' method='post' id='myform'> 
84 <p> 
期 : <input type="text" name ='date' id="datepicker" value=''></p> 
<p> 
入 位 天时， <input type="text" name='days' value='1'></p> 
86 <br/> 
87 <div class="room select box"> 
88 <div class="htl] room - table"> 
89 <?php 
90 Stab str="<table>"; 
91 S$tab str.="<tr><th> 
房型 </th><th> 
门市 价 </th><th> 


会 员 价 </th><th></th></tr>"; 



















































































92 foreach (Srooms as Sroom) { 
93 Stab str.="<tr>"» 
94 S$tab str.="<tdq>" .Sroom["Type"] ."</td>"; 
95 ”Stab str.="<td>".$room["Price"]."</tqd>"; 
96 S$tab str.="<td>".$room["MemberPrice"]."</tqd>"; 
97 Sroomid = $room["Id"]; 
98 $tab str.="<td><a class='btn buy' onClick=\"$('#roomid') .val ($roomid);$('#myform') .submit ();\"> 
预订 </a>" 
99 ”Stab_ str.="</tr>"; 
100 1} 
101 S$tab str.="</table>"; 
102 print S$tab str; 
103 ?> 
104 </div> 
105 </div> 
106 <input type='hidden' name='roomid' id='roomid'> 
107 <input type='hidden' name='openid' id='openid' value="<?php echo $ GET['openid'];?>"> 
108 </form> 加 
109 </div></div></div></div> 
110 </body> 
11 </html> 
第 2~16 行 : 判断 用 户 是 否 已 经 注册 了 账号 ， 如 果 没 有 注册 则 跳 转 到 BindUser.php 文 件 ， 具 体 实现 将 在 下 一 小 节 介 绍 
第 17~27 行 : 如 果 已 经 注册 ， 则 获取 酒店 和 房 源 信息 。 


第 37~39 行 、 第 53~56 行 、 第 71~82 行 


: 使 用 Photoswipe 实 现 酒 店 相册 功能 。Photoswipe 是 一 束 


/2.jpg"><img src= 


/4.jpg"><img src=" 


/6.jpg"><img src=" 


合 在 触摸 屏 手 机 上 使 用 的 相册 展示 包 。 图 9-3 列 表 展 示 缩 略图 ， 点 击 图 片 ， 如 图 9-4 展 示 大 图 ， 左 右 


滑动 ， 可 以 切换 前 后 图 片 。 使 用 该 相册 也 非常 方便 ， 在 http://photoswipe.com/ 下 载 代码 包 ， 将 其 中 的 simple-inheritance.min.js、code-photoswipe-1.0.11.min.js、photoswipe.css 三 个 文件 加 入 到 我 
们 的 代码 库 中 ， 并 在 文件 中 引用 。 你 只 需 将 图 片 链接 加 入 到 id 为 Gallery 的 div 中 ， 如 果 希 望 图 片 多 排 排列 ， 每 一 排 都 是 一 个 id 为 gallery-row 的 div， 如 下 代码 是 两 排 图 片 ， 每 排 3 张 ， 如 图 9-3 所 示 。 注 意 full 
目录 下 的 是 大 图 ，thumb 目 录 下 的 是 缩 略 图 。 


第 43~45 行 、 第 47~51 行 、 第 85 行 : 利用 datepicker 实 现 日 期 选择 功能 并 将 当天 设 为 默认 值 。datepicker 是 一 款 好 用 的 日 历 插 件 ， 在 http://jqueryui.com/datepicker/ 下 载 代码 包 ， 将 jquery-ui.css、 


jquery-1.10.2js 和 jquery-uijs 三 个 文件 放 入 引用 ， 如 图 9-3 和 图 9-5 所 示 。 
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重生 日 生 量 中 | 司 腾 和 通 倒 下 午 10:23 BE 1 Bm 








图 9-4 photoswipe 质 件 
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| 家庭 房 208 198 





特价 大 床 房 175 


图 9-5 ”datepicket 插 件 


第 89~103 行 : 将 房间 信息 以 表格 形式 显示 出 来 。 
第 106 行 : 隐藏 输入 框 ， 存 储 roomid， 当 用 户 点 击 “ 预 订 ” 按 钮 ， 首 先 将 该 输入 框 赋值 为 对 应 房间 的 房间 号 。 


第 107 行 : 隐藏 输入 框 ， 存 储 openid。openid 是 所 有 页 面 的 核心 ， 起 到 判断 用 户 身份 的 作用 。 


9.2.6 用户 注 册页 面 


点 开 图 文 消息 进入 Hoteldetail,php 页 面 ， 如 果 发 现 用 户 还 没 注册 ， 则 跳 转 到 BindUser.php 页 面 。 实 现代 码 如 下 : 





/** 
* BindUser .php 
页 面 
WA 
<!DOCTYPE HIML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<title> 
用 户 注册 </title> 
<style> 
.Content{ 
border:2px solid #d9d9qg9; 
border=radius: 15px; 
} 
.Content pl{ 
width:100%; 











} 
.Content p label{ 
margin-left:10px; 
font-size:18px; 
ont-family:" 
微软 雅 黑 ", "Arial", "Helvetica",sans-serif,verdana; 
Color:#383838; 
} 
.content p input [type="text"] { 
height:32px; 
border:lpx solid #d9d9qg9; 
margin:0px lpx; 
width:90%; 
font-size:18px; 
overflow:hidden; 
} 
</style> 
<link rel="stylesheet" href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../CSS/demos.css"> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery-1.10.2.js"></script> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/../Js/jquery.ui.core.js"></script> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../Js/jquery.ui.widget.js"></script> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery.ui.datepicker.js"></script> 
</head> 
<body> 
<div class="content"> 
<form action='AddUser.php' method='post' igd='myform'> 
<p> 
<label > 


欢迎 来 到 纳 吉 酒 店 ， 注 册 用 户 第 一 次 使 用 微 信 预订 ， 在 原 有 折扣 基础 之 上 再 减 20 


Zt, 
积分 还 可 以 抵 扣 房 费 ， 还 等 什么 ， 来 吧 !!1!</1label> 
</p> 
<br/> 
<p><label> 
姓名 : </label> 
<input type="text" id='name' name='name' /></p> 
<p><label> 
电话 : </label> 
<input type="text" id='telephone' name='telephone'/></p> 
<p><label> 
身份 证 号 码 :</label> 
<input type="text" igd='Identity' name='Identity' /></p> 
<p> 
<a class='btn buy' onClick="$ ('#myform') .submit ();"> 
注册 </a> 
</p> 
<input type='hidden' name='openid' id='openid' value="<?php echo $ GET['openid’'];?>"> 













































































<input am o $ GETI ] 

</form> 

</div> 

</body> 

</html 

BindUser.php 页 面 如 图 9-6 所 示 。 上 点击“ 注册 ”按钮 ， 跳 转 到 AddUser.php。 在 AddUserphp 中 ， 首 先 将 用 户 信息 加 到 数据 库 中 ， 最 后 用 header 方 式 重新 跳 转 回 hoteldetail.php 页 面 中 。 需 要 注意 的 


是 ， 所 有 通过 GET 和 POST 方式 获取 的 数据 在 加 入 数据 库 前 都 要 处 理 一 下 ， 放 置 sq|I 注 入 攻击 。lnt 变 量 用 intval， 非 int 变 量 使 用 SaeMysd| 的 escape 方 法 。 


有 用 全 下 和 车 11:01 B77 82%" 


做 信人 公众 平 台 测 试 号 





欢迎 来 到 纳 言 尊 店 ， 注 册 用 户 第 一 次 
使 用 短信 预 1j ， 在 后 有 折扣 基础 之 上 
rr 积分 还 可 以 抵 扣 房 费 ， 还 等 
什么 ， 来 








姓名 
起 歌 


电话 : 
Up51285321456 


届 份 证 号 码 : 
234568970542123 











图 9-6 用户 注册 





















































/** 
* AddUser .php 
A 
<?php 
smysql = new SaeMysal (); 
$OpenId=$mysql->escape ($ POST['openid']); 
$Telephone=$mysql->escape ($ POST['telephone']); 
SName=$mysql->escape ($ POSTI['name']); 
$Identity=$mysql->escape ($ POST['Identity']); 
$sql = "update ‘bh User set Telephone="'$Telephone',Name="'$Name',Identity='$Identity',Type=" 
虚拟 忆 卡 ',Credits=0 where OpenIgd='$OpenId'™"; 
$mysql->runSql ($sql); 
if ($mysql->errno() != 0) 
{ 
die ("Error:".s$mysgql->errmsg () ) ， 


} 
smysql->closeDb () ， 
$url = 'http://8.huoyaxiaotu.sinaapp.com/BookHotel/hoteldetail.php? hoteliq='.$ POST['hotelid'].'é&openid=".$OpenId; 
header ('Location:"' .$url); 
?> 











9.2.7 ”添加 订单 页 面 


当 用 户 点 击 酒店 页 面 的 “预订 ”按钮 ， 页 面 跳 转 到 AddOrder.php 页 面 。 




























































































1 
<?php 
2 
require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../lib/weixin.class.php'; 
3 
Smysal = new SaeMysal () ， 
4 
$openid=$mysql->escape ($ POST['openid']); 
5 
$sql = "select count (*) from ‘bh Order where ‘OpenId ={$openid}"; 
6 
$count=$mysql->getVar ($sql); 
7 
$isFirstOrder = $count == 0?true:false; 
8 
$RoomId = intval($ POST['roomid']); 
9 
$sql = "select * from bh Room where 1d =$RoomId"; 
10 
$roominfo=$mysql->getLine ($sql); 
1 
Spbrice = $roominfol["MemberPrice"]; 
六 
$Total = $price*intval($ POST['days']); 
13 
if ($isFirstOrder) 
14 
{ 
15 
$Total=$Total-20; 
16 
$sdiscount = 20; 
I 
} 
18 
$date=date ('Y-m-d',strtotime ($mysql->escape ($ POST['date']))); 
19 
$Count=intval ($ POST['days']); 
20 
$sql = "insert into bh Order (RoomId, Time, OpenlId, Price, Count, Total,Finished,FirstOrder) 
21 
values (SRoomId， ‘$date', 'S$openid',s$price, $Count, S$Total,false, $isFirstOrder)"; 
22 
Smysal=>runSal (Ss0l) > 
23 
$sql = "select * from bh HotelInfo where Id ="'".$roominfo["HotelId"].™'"; 
24 
$HotelInfo=$mysql->getLine ($sql); 
25 
if ($mysql->errno() != 0) 
26 
{ 
27 
die ("Error:".s$mysgql->errmsg () ) ， 
28 } 
29 
smysql->closeDb () ; 
30 
?> 
sal 
<html> 
32 
<head> 
33 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
34 
<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
33 
<meta name="format-detection" content="telephone=no" /> 
36 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
37 
<link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" /> 
38 
<title> 
预订 酒店 </title> 
39 
</head> 


40 


<body> 











41 
<?php 
echo '<div class="d-left-module mt1l5"><div class="inner m-hotel-overview" id="jxDescTab">'; 
43 
echo '<h2 class="facility-title"> 














预订 成 功 ， 欢 迎 入 住 </h2><div class="hotel-introduce" id="descContent"><div class="base-info bordertop clrfix">'; 
44 














echo '<dl class="inform-list"><dt> 


























MM 
店 : </dt><dd><cite>' .S$HotelInfo["Name"].'</cite></dd></dl>'; 























45 
echo '<dl class="inform-list"><dt> 

数 

量 : </gdt><dd><cite>' .$Count.' 

天 </cite></dd></dl>'; 

46 
echo '<dl class="inform-list"><dt> 

房 

型 : </dt><dd><cite>'.$roominfo["Type"].'</cite></dd></dl>'; 

47 





echo '<dl class="inform-list"><dt> 
入 住 日 期 : </gdt><dd><cite>' .$date.'</cite></dd></dl>'; 
























































echo '<dl class="inform-list"><gdt> 





xs 
[= 


IJ 凡 
价 : </dt><dd><cite>' .S$roominfo["MemberPrice"].' 
i</cite></dd></d1l>'; 














49 
if ($isFirstOrder) 
50 
{ 
echo '<dl class="inform-list"><dt> 


扣 : </dt><qdd><cite>' .$discount.' 
元 </cite></dd></dl>'; 
52 
} 
53 





echo '<dl class="inform-list"><dt> 





VD 


价 : </dt><add><ecite>' .S$Total:’ 
元 </cite> </dd></d1l>'; 
54 
echo '<dl class="inform-list"><dt> 























: </dt><dd><cite>'.$HotelInfo["Telephone"].'</cite></dd></dl>'; 











echo '<dl class="inform-list"><dt> 

















地 
址 : </dt><dd><cite>' .S$HotelInfo["Address"].'</cite></dd></dl>'; 
56 echo '</div></div></div></div>'; 

5 


?> 
</body> 


</html> 


第 3~7 行 : 判断 用 户 是 否 为 第 一 次 下 单 。 对 第 一 次 下 单 的 用 户 ， 抵 扣 20 元 。 


第 18 行 : 由 于 MySq 的 日 期 类 型 需要 “Y-m-d” 的 格式 。 我 们 需要 转换 下 格式 ， 首 先 用 escape 做 下 处 理 ， 放 置 sql 注 入， 再 用 strtotime 函 数 转换 成 time 类 型 ， 最 后 date 函 数 转换 成 “Y-m-d” 格 式 的 日 
期 格式 。 


第 41~57 行 : 订单 完成 ， 显 示 订 单 详情 。 


效果 如 图 9-7 所 示 。 


eevee 中 国联 通 会 下 午 12:27  @ 了 7** 380% 


公众 平台 测试 号 
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功 ， 欢 迎 入 住 





酒店 : 纳 二 酒店 湖 东 店 

数量 : | 法 

大 床 房 B 

人 住 日 期 : 2014-U6-12 

会 员 价 : 188 元 

区 扣 : 20 元 

168 元 

电话: 051286457893 

地 址 : 陶 州 市 工业 园区 上 旺 墩 路 213 号 


3 
恬 


Bk 
= 


图 9-7 预订 成 功 


9.2.8 我 的 订单 页 面 


用 户 点 击 “ 我 的 订单 ”菜单 ， 会 打开 MyOrder.php， 具 体 代码 如 下 : 



























































/** 
* MyOrder .php 
A 
1 
<?php 
2 
require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../1ib/common.func.php'; 
3 
require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../lib/weixin.class.php'; 
4 
require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../model/SendMsgDB .php'; 
二 
$token = weixin::getAuthToken($ GET['code']); 
6 
Sopenid = $token["openid"]; 
a 
$data = array(); 
8 


smysql = new SaeMysql (); 





$sql = "select * from bh Order where OpenId ='$openid' and Finished=false"; 























































































































































































































































































































































































































le=1.0, user-scalable=no" /> 





4881/0EBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" 





1 











4881/OEBPS/Text/../Js/jquery-1.10.2.js"></script> 
































10 $Sorderlist=$mysql->getData ($sql); 

1 foreach (S$orderlist as S$order)f{ 

12 Sitem = array(); 

13 Sroomid = S$order["RoomId"]; 

14 $sql = "select * from bh Room where Id =$roomid"; 

LS Sroom = $mysql->getLine ($sql); 

16 ShotelLidq= $room["HotelId"]; 

下 水 $sql = "select * from bh HotelInfo where Id =$hotelid"; 

18 Shotelinfo=$mysql->getLine ($sql); 

下 Sitem = array( 

20 "id"=>$order["Id"], 

21 "hotelname"=>$hotelinfol"Name"], 

22 "date"=>$order["Time"], 

23 "count"=>$order["Count"], 

24 "price"=>$order["Price"], 

25 "total"=>$order["Total"], 

26 "address"=>$hotelinfo["Address"], 

之 7 "telephone"=>$hotelinfol"Telephone"], 

28 "type"=>$room["Type"] 

29 ) 

30 $data[]=$item; 

31 } 

32 if ($mysql->errno() != 0) 

33 { 

34 die ("Error:".s$mysql->errmsg () ) 

35 } 

36 smysql->closeDb () ， 

37 ?> 

38 <!IDOCTYPE HTIML> 

39 <html> 

40 <head> 

41 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 

42 <meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scal 
43 <meta name="format-detection" content="telephone=no" /> 

44 <meta name="apple-mobile-web-app-capable" content="yes" /> 

45 <link href="nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/] 
46 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../Js/jquery.ui.core.js"></script> 
47 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery.ui.widget.js"></script> 
48 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/] 
49 <script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery-ui.js"></script> 
50 <link rel="stylesheet" href="nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../CSS/jquery-ui.css"> 
5 <title> 

我 的 订单 </title> 

52 </head> 

3 <body> 

54 <form action='DeleteOrder.php' methogd='post' id='myform'> 

55 <h2 class="detail title"> 

订单 列表 </h2> 

56 <?php 

57 foreach ($data as Sitem) { 

58 echo '<div class="d-left-module mt1i5"><div class="inner m-hotel-overview" id="jxDescTab">'; 

59 echo '<h2 class="facility-title"><span class="fr inform-error">'; 

60 echo "<a class='btn buy' onClick=\"$ ('#orderid') .val (".$item["id"] .");$('#myform') .submit ();\"> 
退 订 </a></span>"; 

61 echo ' 

订单 号 : ' .$item["igd"].'</h2>'; 

62 echo '<div class="hotel-introduce" id="descContent"><div class="base-info bordertop clrfix">'; 
63 echo '<dl class="inform-list"><dt> 

店 : </dt><dqd><cite>' .$item["hotelname"].'</cite></dd></dl>'; 

echo '<dl class="inform-list"><dt> 

型 : </dt><dd><cite>'.$item ["type"].'</cite></dd></dl>'; 

65 echo '<dl class="inform-list"><dt> 

入 住 日 期 : </dt><dd><cite>'. $item["date"].'</cite></dd></dl>'; 

66 echo '<dl class="inform-list"><dt> 

价 

格 : </qdt><dqd><cite>' .$item["price"].' </cite></dd></dl>'; 

数 echo '<dl class="inform-list"><dt> 

量 : </gdt><gg><cite>'.$item["count"].'</cite></dd></dl>'; 

echo '<dl class="inform-list"><dt> 

额 ; </dt><gdd><cite>'.$item["total"].'</cite></dq></dl>'; 

晶 echo '<dl class="inform-list"><dt> 

话 : </dt><dd><cite><a href="tel:'.$item["telephone"].'">'.$item["telephone"] .'</a></cite></dd></d1l>'; 
echo '<dl class="inform-list"><dt> 

地 





址 : </dt><dd><cite>' .$item["address"]. 


'</cite></do></d1>'; 
echo '</div></div></div></div>'; 

} 

?> 

<input type='hidden' name='orderid' id='orderid'> 
</form> 

</body> 

</html> 














第 5~6 行 : 前 面 提 到 view 菜 单 的 链接 地 址 实际 上 是 OAuth2.0 的 验证 链接 ， 用 户 点 击 该 菜单 ， 会 先 访问 该 验证 链接 地 址 ， 随 后 ， 


封装 的 getAuthToken 函 数 ， 获 取 token， 这 里 包含 了 用 户 的 openid 信 息 。 


第 8~36 行 : 查找 用 户 的 所 有 未 完成 订单 ， 并 封装 到 数组 中 。 
第 56~73 行 : 显示 所 有 订单 信息 ， 如 图 9-8 所 示 。 


第 69 行 : 


跳 转 到 链接 地 址 中 设置 的 跳 转 地 址 同时 发 送 code 值 。 调 用 在 weixin 类 中 


使 页 面 中 的 电话 能 直接 拨打 。<a href= “tel:051278945625”>051278945625</a>。 在 链接 前 加 上 tel 标 记 就 可 以 实现 点 击 电话 ， 直 接 拨 打 的 效果 了 。 如 图 9-9 所 示 。 














房型 : 


入 性 日 期 ; 


[| : 3 











儿 言 酒店 湖 东 让 
术 床 房 昌 
2014-06-12 
188 


168 
051286457893 
苏州 市 工业 园区 旺 雯 中 213 号 





纳 吉 酒店 左岸 店 
太 床 房 B 
2014-05-31 
188 


168 
Uol2003D4 24 
苏州 市 工业 园区 左岸 商业 街 188 号 





提示 


确定 拨打 电话 : 051286457893 吗 ? 


硼 定 








图 9-10 



























































/** 
* DeleteOrder .php 
大 
2 
<?php 
Smysal = new SaeMysal () ， 
S$Sorqerid=Smysdql->escape ($ POST['orderid']); 

$sql = "delete from bh Order where Id = S$orderid"; 

$mysql->runSgql ($sql); | 

if ($mysql->errno() != 0) 

{ 

die ("Error:".s$mysql->errmsg () ) 

} 

smysql->closeDb () ， 
?> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<link href="nttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" /> 
<title> 
删除 订单 </title> 
</head> 
<body> 
<?php 





echo '<div class="d-left-module mt1l5"><div class="inner m-hotel-overview" id="jxDescTab">'; 
echo '<h2 class="facility-title"> 

退 订 成 功 ， 欢 迎 再 次 入 住 </h2><div class="hotel-introduce" id="descContent"><div class="base-info bordertop clrfix">'; 
echo '</div></div></div></div>'; 























?> 
</body> 
</html> 





订单 后 台 管 理 是 供 酒店 方 使 用 的 ， 实 际 上 应 该 有 一 整套 的 CRM 与 之 结合 ， 这 里 简化 提供 订单 管理 后 台 以 作 示 范 。 显 示 所 有 未 完成 订单 ， 并 提供 入 住处 理 和 过 期 处 理 操作 ， 如 图 9-11 所 示 ， 具 体 代码 如 


/** 
*OrderManagement .php 
*/ 


<?php 








require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0 
require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0! 
$data = array(); 


BPS/Text/../l1ib/common.func.php'; 
BPS/Text/../model/SendMsgDB .php'; 

















a 
1 
EY 
1 




















Smysal = new SaeMysal () ， 
$sql = "select * from bh Order where Finished =false"; 
$orderlist=$mysql->getData ($sql); 
foreach (S$orderlist as Soraqer) { 
Sitem = array(); 
Sroomid = S$order["RoomId"]; 
$sql = "select * from bh Room where Id =$roomid"; 
Sroom = $mysql->getLine ($sql); 
ShotelLidq= $room["HotelId"]; 
$sql = "select * from bh HotelInfo where Id =$hotelid"; 
$hotelinfo=$mysql->getLine ($sql); 
Sitem = array( 
"id"=>$order["Id"], 
"hotelname"=>$hotelinfo["Name"], 
"date"=>$order["Time"], 
"count"=>$order["Count"], 
"price"=>$order["Price"], 
"total"=>$order["Total"], 
"address"=>$hotelinfo["Address"], 
"telephone"=>$hotelinfol"Telephone"], 
"type"=>$room["Type"] 











































































































); 

$sdata[]=$item; 
} 
if ($mysql->errno() != 0) 
{ 


} 
smysql->closeDb (); 








die ("Error:".S$mysgql->errmsg () ) ， 














?> 

<!DOCTYPE HTML> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 














<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" /> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/O0EBPS/Text/../Js/jquery.ui.core.js"></script> 

<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery.ui.widget.js"></script> 













































































<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0EBPS/Text/../Js/jquery-1.10.2.js"></script> 
<script src="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../Js/jquery-ui.js"></script> 
<link rel="stylesheet" href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/jquery-ui.css"> 
<title> 
订单 </title> 
</head> 
<body> 
<h2 class="detail title"> 
订单 列表 </n2> 
<table class="gridtable" width="98%"> 
<tr> 
<th> 























[tt 













































































订单 号 </th> 





房型 </th> 

















价格 </th> 


总 价 </th> 
</tr> 
<?php 
foreach ($data as Sitem) { 
echo '‘'<tr>'，; 
echo "<td>{$item['id'] }</td>"; 
echo "<td>{$item['type'] }</tqd>"; 
echo "<td>{$item['date'] }</tqd>"; 
echo "<td>{$item['count']}</tqd>"; 
echo "<td>{$item['price'] }</td>"; 
echo "<td>{$item['total']}</tqd>"; 
echo "<td><a href='FinishOrder.php?orderid={$item['id']}'> 
入 住 </a> <a href= 'OrderOverTime.php?orderid={$item['id']}'> 
过 期 </a></td>"; 
echo ‘'<tr>'; 





<th> 






























































} 
?> 
</table> 
</body> 
</html> 


当 用 户 入 住 ， 选 择 对 应 订单 ， 点 击 “ 入 住 ”按钮 ， 如 图 9-12 所 示 : 

























































































/** 
* FinisheOrder .php 
类 
/ 
1. <?php 
2. Smysql = new SaeMysd] () ， 
3. Sorderid=$mysql->escape($ GET['orderid']); 
4. $sql = "select * from bh Order where Id = $orderid"; 
5. S$order = $mysql->getLine ($sqgl); 
6. S$sql = "update bh User set Credits = {S$order['Total']} where OpenId = '{$order['OpenId']}'"; 
7. S$mysgql->runSqgl ($sql); 
8. S$sql = "update bh Order set Finished = true where Id = $orderid"; 
9. S$mysql->runSgl ($sqgl); 
10. if ($mysql->errno() != 0) 
I 
12. qie ("Error:" .Smysdql->errmsd() ); 
13%. 直 
14. Smysql->closeDb () ， 
15. ?> 
16. <html> 
17. <head> 
18. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
19. <meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
20. <meta name="format-detection" content="telephone=no" /> 




















21. <meta name="apple-mobile-web-app-capable" content="yes" /> 
22. <link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" /> 
23. <title> 


I 






































订单 完成 </title> 
24. </head> 

25. <body> 

26. <?php 














27. echo '<div class="d-left-module mt1i5"><div class="inner m-hotel-overview" id="jxDescTab">'; 

28. echo '<h2 class="facility-title"> 

欢迎 入 住 </h2><div class="hotel-introduce" igd="descContent"><div class="base-info bordertop clrfix">'; 
29. echo '</div></div></div></div>'; 












































30. ?> 
31. </body> 
32. </html> 


第 6~7 行 : 给 用 户 增加 积分 。 


第 8~9 行 : 将 订单 置 为 完成 。 


DB 8.huoyaxiaotu.sinaapp.com/BookHotel/OrderManagement.php 


| 
”| [| 
EE EE 
159 -名 
1 | 145 


1 
2014-05-31 


图 9-11 
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图 9-12 


9.2.11 我 的 会 员 卡 


显示 会 员 信息 及 积分 ， 如 图 9-13 所 示 。 





四 





BPSVText/../Lib/ycomrmmon.func.php' 
BPS/Text/../lib/weixin.class.php'; 
BPS/Text/../model/SendMsgDB .php'; 


require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0 

require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0 

require once 'http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/0 

$token = weixin::getAuthToken($ GET['code']); 

$openid = $token["openigd"]; 
Smysal = new SaeMysal () ， 











四 












































四 





























$sql = "select * from bh User where OpenIq ="'$openid'"; 
$info=$mysql->getLine ($sql); 
if ($mysql->errno() != 0) 

{ 





die ("Error:".s$mysql->errmsg () ) ， 

} 

smysql->closeDb () ， 
?> 
<!DOCTYPE HTML> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<meta name="viewport" content="width=screen-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" /> 
<meta name="format-detection" content="telephone=no" /> 
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<link href="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/14881/OEBPS/Text/../CSS/styles.css" type="text/css" rel="stylesheet" /> 
<title> 
我 的 会 员 卡 </title> 
</head> 
<body> 
<?php 
































工 












































echo '<div class="d-left-module mt15"><QqiV class="inner m-hotel-overview" id="jxDescTab">'; 
echo "<h2 class="facility-title"> 
会 员 卡 </n2><qiv class="hotel-introduce" id="descContent"><div class="base-info bordertop clrfix">'; 
























































echo '<dl class="inform-list"><dt> 

姓 

名 : </dt><dd><cite>' .$info["Name"] .'</cite></dd></dl>'; 
echo '<dl class="inform-list"><dt> 

电 

话 : </dt><dqd><cite>' .$info["Telephone"].'</cite></dd></dl>'; 
echo '<dl class="inform-list"><dt> 

会 员 卡 : </dt><dd><cite>' .$info["Type"].'</cite></dd></qdl>'; 
echo '<dl class="inform-list"><dt> 




















口 
人 \ 
分 : </dt><dqd><cite>' .$info["Credits"]. 
'</cite></dd></d1l>'; 
echo '</div></div></div></div>'; 





2 
</body> 
</html> 


Do 


er 


D1286032145 
虚拟 忆 卡 
159 





图 9-13 


第 10 草 ”游戏 开 友 一 一 谁 是 卧底 


腾讯 什么 产品 最 有 名 : QQ、 微 信 ; 腾讯 什么 产品 最 赚钱 : 游戏 。 腾 讯 的 收入 大 部 分 来 自 游戏 ，QQ 居 功 至 伟 。 微 信 商 业 化 党 试 也 以 游戏 作为 开端 ， 打 飞机 着 实 火 了 很 长 一 段 时 间 ， 天 天 系列 游戏 和 全 民 
系列 游戏 也 为 微 信 带 来 很 多 营 收 。 为 什么 QQ、 微 信和 在 游戏 推广 与 分 友 上 有 这 么 强大 的 能 力 呢 ? 核心 在 于 社交 软件 的 强 粘性 属性 和 社交 链 。 以 前 有 个 段子 说 : 最 痛苦 的 不 是 没有 快乐 ， 而 是 快乐 无 人 分 享 。 分 
享 与 交流 是 社交 软件 的 核心 ， 微 信 相 比 QQ 有 着 更 得 天 独 厚 的 优势 ， 因 为 它 是 随身 携带 的 ， 天 然 具 有 分 享 属性 。 所 以 在 微 信 上 开发 游戏 ， 有 着 比 普通 App 更 好 的 传播 能 力 。 这 一 章 我 们 介绍 一 个 大 家 都 很 熟悉 
的 游戏 : 谁 是 卧底 。 这 个 游戏 规则 简单 ， 是 朋友 聚会 的 必 点 之 菜 ， 应 用 商店 里 也 有 很 多 类 似 的 游戏 ， 这 个 游戏 非常 契合 微 信 的 特点 ， 所 以 我 们 以 这 个 游戏 作为 游戏 开发 的 案例 。 


10.1 谁 是 EN 旗 功 能 及 设计 


10.1.1 “游戏 规则 
谁 是 卧底 适合 多 人 玩 ， 所 有 玩家 分 三 种 角色 : 法 官 (出 题 及 裁决 ) 、 卧 底 以 及 平民 。 卧 底 指 人 数 较 少 的 一 方 ， 平 民 是 人 数 较 多 的 一 方 ， 并 无 其 他 含义 。 游 戏 支 持 最 少 5 人 ， 最 多 14 人 玩 ， 其 中 一 人 是 法 
官 。 


游戏 开始 ， 法 官 选 择 两 个 字数 一 样 ， 意 义 相关 的 词语 ， 并 随机 分 发 给 其 他 所 有 玩家 。 玩 家 需 对 自己 的 词 保 密 ， 防 止 泄露 给 其 他 玩家 ， 此 时 卧底 及 平民 都 不 知道 相互 的 身份 ， 也 不 知道 自己 的 身份 。 在 每 
一 轮 中 ， 玩 家 先 顺序 描述 自己 的 词语 ， 最 好 不 要 太 过 明显 ， 既 不 能 让 卧底 察觉 ， 也 要 给 同伴 上 暗示。 每 轮 描述 完毕 ， 所 有 在 场 的 人 投票 选 出 怀疑 的 卧底 人 选 ， 得 票 最 多 的 人 出 局 。 若 卧底 全 部 出 局 ， 游 戏 结 
束 。 否 则 游戏 继续 ， 如 有 两 人 得 票 相同 ， 则 再 次 进入 PK， 大 家 从 两 人 中 选 出 一 个 。 若 卧底 撑 到 最 后 一 轮 (卧底 人 数 与 平民 人 数 一 致 ) ， 则 卧底 胜利 ， 反 之 则 平民 胜利 。 输 的 一 方 要 接受 惩罚 。 


10.1 谁 是 EN 医 功 能 及 设计 


10.1.1 ”游戏 规则 


谁 是 卧底 适合 多 人 玩 ， 所 有 玩家 分 三 种 角色 : 法 官 (出 题 及 裁决 ) 、 卧 底 以 及 平民 。 卧 底 指 人 数 较 少 的 一 方 ， 平 民 是 人 数 较 多 的 一 方 ， 并 无 其 他 含义 。 游 戏 支 持 最 少 9 人 ， 最 多 14 人 玩 ， 其 中 一 人 是 法 
官 。 


游戏 开始 ， 法 官 选 择 两 个 字数 一 样 ， 意 义 相关 的 词语 ， 并 随机 分 发 给 其 他 所 有 玩家 。 玩 家 需 对 自己 的 词 保 密 ， 防 止 泄露 给 其 他 玩家 ， 此 时 卧底 及 平民 都 不 知道 相互 的 身份 ， 也 不 知道 自己 的 身份 。 在 每 


一 轮 中 ， 玩 家 先 顺序 描述 自己 的 词语 ， 最 好 不 要 太 过 明显 ， 既 不 能 让 卧底 察觉 ， 也 要 给 同伴 上 暗示。 每 轮 描述 完毕 ， 所 有 在 场 的 人 投票 选 出 怀疑 的 卧底 人 选 ， 得 票 最 多 的 人 出 局 。 若 卧底 全 部 出 局 ， 游 戏 结 


束 。 否 则 游戏 继续 ， 如 有 两 人 得 票 相同 ， 则 再 次 进入 PK， 大 家 从 两 人 中 选 出 一 个 。 若 卧底 撑 到 最 后 一 轮 (卧底 人 数 与 平民 人 数 一 致 ) ， 则 卧底 胜利 ， 反 之 则 平民 胜利 。 输 的 一 方 要 接 


10.1.2 核心 流程 


1) 玩家 选择 好 法 官 后 ， 由 法 官 创 建 房间 ， 法 官 在 公众 号 中 发 送 1， 公 众 号 通过 openid 记 录 该 用 户 并 标记 用 户 正 在 创建 房间 (creating) ， 等 待 用 户 的 进一步 消息 。 


2) 法 官 收 到 提示 消息 后 ， 根 据 提示 输入 玩家 人 数 (4~13) ， 输 入 正确 ， 公 众 号 后 台 会 为 用 户 选择 一 个 空闲 的 房间 ， 随 机 选择 一 组 词语 ， 并 随机 分 配给 玩家 。 并 将 该 用 户 的 状态 标记 为 created。 发 送 消 


息 给 该 用 户 。 


3) 法 官 收 到 消息 ， 消 息 中 指明 : 房间 号 、 卧 底 词 、 平 民 词 及 卧底 的 ID。 法 官 随 后 通知 玩家 加 入 房间 。 


4) 玩家 发 送 房间 号 (大 于 1000 的 数字 ) 给 公众 号 后 台 ， 公 众 号 后 台 根 据 玩 家 加 入 的 次 序 分 配 ID， 第 一 个 加 入 的 是 1 号 ， 依 次 类 推 ， 直 到 房间 满 。 并 将 对 应 的 词语 发 送 给 玩家 。 


5) 当 最 后 一 个 玩家 加 入 房间 后 ， 游 戏 开 始 。 


游戏 结束 ， 输 的 一 方 输入 0， 得 到 惩罚 信息 ， 接 受 惩罚 。 


6) 游戏 结束 或 者 法 官 对 词语 不 满意 ， 法 官 可 以 输入 “ 换 ”， 后 台 会 为 房间 重新 分 配 词语 ， 无 需 重新 创建 房间 。 


7) 法 官 也 可 以 自 定 义 词语 ， 在 房间 创建 完毕 的 情况 下 (状态 为 “created”) ， 输 入 “ 改 ”， 后 台 会 将 用 户 的 状态 改 为 “change" 


众 号 后 台 ， 就 可 以 使 用 自 定 义 的 词语 了 。 


10.1.3 “数据 表 设 计 


在 SAE 的 MySQL 中 ， 创 建 数据 表 ， 见 表 10-1 至 表 10-4。 


openld 

status 

roomid 
curUserld 
underCoverld 
Count 

wordl 


word2 


字 上 段 名 
Id 
CreatedTime 
Free 


表 10-1 Bg_User 表 
字段 类 型 字段 描述 


varchar(100) 法 官 的 openid， 


varchar(20) 法 官 创 建 游戏 的 阶段 


int(11) 分 配给 法 官 的 房间 号 


int(11) 当前 可 分 配 的 Id 
varchar(20) 也 压 的 Id 
int(11) 玩家 数量 


varchar(20) 由 奔 词 


varchar(20) 玉民 词 
表 10-2 Beg_Rooms 表 


几 


j 


改 
池 
冉 


字段 拉 述 


int(11) 房间 Id4， 主 键 ， 目 增长 ，1000 以 上 


， 等 待 用 户 按照 规定 格式 输入 词语 。 法 官 根据 提示 发 送 两 个 词 


语 给 公 


datetime 房间 创建 时 间 ， 每 次 分 配 词语 会 更 新 时 间 ， 如 果 超 过 


一 定时 间 未 用 ， 会 被 回收 


tinyint(1) 房间 是 否 可 用 


表 10-3 Bg Words 表 


字 段 名 字段 类 型 字段 描述 


Id int(11) 闻 语 Id4， 主 键 ， 目 增长 


Wordl Varchar(20) 耻 展 词 


Word2 Varchar(20) 平民 词 


表 10-4 Bg_Punish 表 
字 段 名 字段 类 型 字段 描述 
. int(11) 惩罚 项 Id， 主 键 ， 自 增长 
Item Varchar(100) 征 罚 内 容 


10.2 代码 实现 


我 们 定义 UnderCover 类 ， 它 实现 全 部 的 游戏 业务 逻辑 ， 继 承 自 weixin 类 。weixin 类 在 接口 部 分 已 经 介绍 过 了 ， 封 装 了 与 微 信 的 所 有 交互 ， 包 括 token 的 获取 ， 消 息 类 型 的 判断 ， 各 种 消息 的 发 送 等 内 
容 。 本 章节 的 代码 都 放置 在 BoardGame 目 录 下 。 下 面 详细 介绍 具体 的 业务 逻辑 。 


10.2.1 消息 判断 


ProcessMessage 是 入 口 函数 ， 对 接收 到 的 消息 进行 判断 和 处 理 。 如 果 是 文本 消息 ， 根 据 内 容 做 进一步 处 理 ， 其 他 类 型 的 消息 将 返回 默认 的 提示 消息 。 由 于 用 户 与 公众 号 平台 的 每 一 次 交互 都 是 独立 
的 ， 代 码 里 无 法 保存 用 户 与 公众 号 后 台 的 交互 内 容 ， 所 以 我 们 在 bg_user 表 中 引入 了 状态 变量 ， 用 于 判断 用 户 处 于 什么 阶段 。Status 变 量 主要 有 三 个 值 : creating 是 法 官 开始 创建 游戏 ， 还 未 分 配 房间 ， 公 众 
号 后 台 等 待 法 官 输入 玩家 人 数 ; created 是 已 经 分 配 好 房间 ,分配 好 词语 ， 进 入 游戏 状态 ;change 是 法 官 自 定义 词语 ， 公 众 号 后 台 等 待 用 户 输入 自 定义 词语 。 具 体 实现 代码 如 下 : 








判断 用 户 消息 及 事件 类 型 : 











function ProcessMessage ($data) 








$status = S$this->getStatusByOpenid ($data->FromUserName); 
Snum = intval ($data->Content); 


if (Sthis->isTextMsg()) 1 
// 








惩罚 信息 








if($data->Content == '0') 
{ 
$sthis->getPunish(); 
} 
不 
准备 创建 游戏 
elseif ($data->Content == '1') 





{ 





$sthis->createGame ($data); 
Scontent = " 

正在 创建 谁 是 卧底 ， 

请 输入 游戏 人 数 (4 


~13 
之 间 ， 不 包括 法 官 哦 ) "; 
Sthis->outputText ($content); 


























} 


























// 
加 入 房间 
elseif ($num >= 1000) 
{ 
$sthis->joinRoom ($num); 
} 
// 
在 输入 1 
后 ， 再 输入 4 
~13 
， 创 建 房间 
elseif(Sstatus=='creatingd' && Snum <= 13 && Snum >=4) 
{ 
$sthis->createRoom ($data); 
} 
2 
不 在 4 
~13 


范围 内 ， 提 示 错 误 

elseif ($status=="'creating') 
{ 
输入 的 数字 必须 是 (4 


13) 
之 间 的 数字 哦 ， 请 重新 输入 "; 


Sthis->outputText ($content); 
} 


// 














$content = " 








elseif ($status=="'created' && S$data->Content==" 





$sthis->replaceWord ($data->FromUserName); 


// 
改 词 ， 法 官 自 定义 词语 




















elseif ($status=="'created' && S$data->Content==" 
改 ') 
{ 
$sthis->changeWord ($data->FromUserName); 
} 
// 
法 官 提交 的 新 词 
elseif ($status == 'change') 





$sthis->processChangeWord ($data); 


// 








都 不 是 ， 则 提示 默认 消息 
else 





sthis->defaultMessage () ， 


elsef 
sthis->defaultMessage () ， 





接 下 来 详细 介绍 上 面 的 处 理 函 数 。 


10.2.2 创建 游戏 


当 用 户 输入 1 后 ， 调 用 createGame 国 数 ， 该 国 数 将 bg_user 中 的 status 设 为 creating， 如 果 该 用 户 是 首次 使 用 ， 则 将 用 户 openid 加 入 表 中 。 





function createGame ($data) 
{ 
smysql = new SaeMysal () ， 
$sql = "select count (*) from bg user where openid = '$data->FromUserName'™"; 
$isExist = $mysql->getVar ($sqgql); 
if ($isExist == 1) 
{ 


} 


else 


{ 


$sql = " insert into bg user(openid, status) values('$data->FromUserName', 'creating')"; 








$sql = " update bg user set status = 'creating'"; 





} 

smysql->runSsgl ($sql); 

if ($mysql->errno() != 0) 
{ 


die ("Error:".S$mysql->errmsg () ); 


} 
smysql->closeDb () ， 





10.2.3 ”创建 房间 


法 官 输入 1 后 ， 收 到 提示 消息 后 ， 按 提示 消息 输入 参与 游戏 的 人 数 (4~ 13) ， 公 众 号 后 台 接 到 消息 后 调用 CreateRoom 函 数 。 具 体 代码 如 下 所 示 : 





function createRoom ($data) 
{ 

Sallocate = $this->getAllocate ($data->Content); 

$SUnderCover= S$this->selectUnderCover ($allocate[0], $data->Content);} 

Swords = S$this->getWords (); 

$sthis->saveWordInfo ($words['wordl'], $words['word2'], S$UnderCover, S$data->FromUserName, S$data->Content); 

Sroomid = $this->getRoomId ($data->FromUserName); 

$content=" 
建 房 成 功 !".$this->detailInfo($roomid, $allocate[0], $allocate[1], $words['wordl'], $words['word2'], $UnderCover); 
Sthis->outputText ($content); 


~ 一 





























} 


getAllocate 根 据 玩家 数 确定 卧底 和 平民 比例 。SelectUnderCover 函 数 随机 选择 甲 底 |d， 具 体 实现 过 程 : 将 玩家 |d (从 1 开始 ) 按 序 放 入 数组 中 ， 利 用 php 的 洗 牌 函数 -shuffle， 将 数组 顺序 随机 打 乱 ， 
假设 卧底 有 n 个 ， 那 么 将 数组 的 前 n 个 1d 选 为 卧底 。 具 体 代码 如 下 : 





function getAllocate (Snum) 


{ 





$allocate = array(); 
switch (Snum) 


{ 






















































































Case '4': 
$allocate[]=1; 
$allocate[]=3;break; 
Case 'D': 
$allocate[]=1; 
$allocate[]=4;break; 
Case '6': 
$allocate[]=2; 
$allocate[]=4;break; 
Case '7': 
$allocate[]=2; 
$allocate[]=5;break; 
Case '8': 
$allocate[]=2; 
$allocate[]=6;break; 
Case '9': 
$allocate[]=2; 
$allocate[]=7;break; 
case '10': 
$allocate[]=3; 
$allocate[]=7;break; 
case '11': 
$allocate[]=3; 
$allocate[]=8;break; 
case '12': 
$allocate[]=3; 
$allocate[]=9;break; 
case '13': 
$allocate[]=3; 
$allocate[]=10;break; 
} 
return S$allocate; 














} 
function selectUnderCover ($udcount, S$count) 
{ 
$a = array (); 
for($i = 1; $i <= S$count ; Si++) 
{ 


array push ($a, $i); 


shuffle ($a); 

Sgt i "val ; 

for($i = 1; $i < S$udcount; $i++) 
{ 





Sete,=", "Halgi]y 


return S$str; 


getWords 从 词 库 中 随机 选择 词组 。 实 现 方法 : 从 1~100000 中 随机 选择 一 个 数 ， 查 表 得 到 词 库 中 的 词组 总 量 ， 两 者 取 模 ， 由 于 词组 ld 从 1 开始 ， 而 取 模 可 能 得 到 的 值 范围 是 0，maxid) ， 所 以 加 上 1。 


具体 代码 如 下 : 





function getWords () 


{ 
$id = fanQq(1，100000) ， 


























smysql = new SaeMysql () ， 

$sql = "select max(Id) from bg words"; 
smaxid = $mysql->getVar ($sqgql1); 

$sql = "select * from bg words where 
$words=$mysql->getLine ($sql); 





if ($mysql->errno() != 0) 


{ 


die ("Error:".S$mysql->errmsg () ); 


} 
smysql->closeDb (); 
return Swords; 


Id = mod ($id, $maxid) 


i 省 风 3 


saveWordlnfo 将 词组 ， 卧 底 Id 存 入 bg_user 中 ， 供 游戏 使 用 。getRoomld 选 择 当 前 可 用 的 房间 ， 将 所 选 房间 置 为 不 可 用 ， 保 存 创建 时 间 并 将 房间 号 保存 到 bg_user 表 中 。 











function saveWordIni 





{ 


smysql new SaeMysql] (); 


$sql = "update bg user set status = 'created',Count = $count ,wordl = '$wordl',word2 = '$word2',underCoverI 


$mysql->runSql ($sql); 
if ($mysql->errno() 
{ 


!= 0) 


die ("Error:".S$mysql->errmsg () ); 


} 
smysql->closeDb () ， 
} 
function getRoomId (Sopenid) 


{ 





Smysaql = new SaeMysdal () ， 





fo ($wordl1l, Swordq2，SUnaqerCover， S$openid, $count) 





























wher 





'$SUnderCover',curUserId=1 where openid = '$openid'™"; 

















Q =$ 





[eM 











$sql = "select Id from bg rooms where Free = true"; 
$Id=$mysql->getVar ($sql); 
$sql = "update bg rooms set CreatedTime = NOW() and Free = fals 
SmysalL->runSdl ($sql); 
$sql = "update bg User set roomid = $Id where openid = '$openid' 
$mysql->runSgl ($sql); 

if ($mysql->errno() != 0) 








die ("Error:".S$mysgql->errmsg () ); 


} 
smysql->closeDb (); 
return S$Id; 








Detailinfo 发 送 给 法 官 的 消息 如 下 : 















































fo (Sroomid, S$udcount, S$cilivincount, $wordl, 


function detailIni 
{ 

SCcontent = " 
你 是 法 官 ， 请 让 参与 游戏 的 玩家 对 我 回复 [$roomiq] 
进入 房间 。\n"; 

$content .=" 
房 
号 : $Sroomid\n"; 

SCcontent .=" 
配 
置 : 卧底 " .Suqcount ." 


人 ， 平 民 " .Scilivincount .nm 
人 \n"; 
n 


$co 
耻 底 词 : $word1\ 

$con 
平民 词 : $word2\\ 


$con 


























: Sundercover 
Ns 


$content .= 


"六 


换 一 组 词 ，\n 
复 














出 题 ，\n 

















险 惩 罚 ! ( 


后 ， 不 必 重 建 房 ， 回 复 [ 
)"; 


return S$content; 














油画 


淤 4 成 则 ”下 峡 、 举 昌 ”中 如 下 











10.2.4 换 词 


I。 
r 





$word2, S$undercover) 


在 房间 已 经 创建 好 的 情况 下 (status 为 created) 输入 “ 换 ”， 调用 replaceWord， 具 体 代词 如 下 : 








function replaceWord ($openidg) 


{ 





Sinfo = $this->getRoomInfoByOpenid ($openid); 
$allocate = $this->getAllocate ($info['Count']); 
$SUnderCover= Sthis->se] 











Swords = $this->getWords () ， 


























$sthis->saveWordInfo (Swordqs ['wordq1']， 
$sthis->refreshRoom($info['roomid"']); 
$content=" 

换 词 成 功 !".S$Sthis->detailInfo ($in 
$sthis->outputText ($content); 














} 


首先 调用 getRoomInfoByOpenid， 根 据 openid 到 bg_user 表 中 获取 玩家 人 数 、 房 间 号 等 信 


更 新 房间 时 间 ， 具 体 代码 如 下 : 











function refreshRoom(Sroomid) 


{ 


= NOW () 





smysql = new SaeMysql (); 

$sql = "update bg rooms set CreatedTim 
$mysql->runSql ($sql); 

if ($mysql->errno() != 0) 





{ 





die ("Error:".S$mysql->errmsg () ); 


} 
smysql->closeDb () ， 


$words['word2'], 


$UnderCover, 





where Id =$roomid"; 





ctUnderCover ($allocate[0], $info['Count"]); 


$data->FromUserName, 


a 


$info['Count']); 


fo['roomid'], S$allocate[0], $allocate[1], $words['wordl'], $words['word2'], S$UnderCover); 


息 。 接 下 来 与 createRoom 比 较 类 似 ， 随 机 选择 卧底 ， 随 机 选择 词组 并 存 入 bg_user， 同 时 调用 refreshRoom 


10.2.5” 改 词 


法 官 输入 “ 改 ”， 调 用 changeWord 将 状态 改 为 “change”， 等 待 用 户 输入 词组 。 有 具体 代码 如 下 : 





Hc 





二 














法 官 按照 提示 ， 输 入 词组 ， 


{ 


function changeWord ($openid) 








Smysal = new SaeMysal (); 

$sql = "update bg user set status= 'change' where openid = '$openid'"; 
$count = $mysgql->runSgl ($sgql); 

f (Smysql->errno() != 0) 





一 PP- 


die ("] 


} 





smysql->closeDb () ， 
$content = " 





状元 ， 冠 军 "; 





} 


请 输入 卧底 词 科 民 词 
0D: 





Error:".Smysql 


->errmsg () ); 





公众 号 


$sthis->outputText ($content); 


入 。 得 到 词组 ， 后 面 和 换 词 操 作 是 一 样 的， 具体 代码 如 下 : 





{ 


Swords 
if (count ($words) 


{ 


Swords = explode(" 


三 ee 


，", S$data->Content); 


在 





二 














如 


改 


} 


if (count ($words) 


{ 


$content = " 














: 状元 ， 冠军 "; 








按照 正确 格式 输入 卧底 词 和 平民 词 ， 


l= 2) 


function processChangeWord ($data) 





Sthis->outputText ($conten 


} 


Sinfo = S$this->getRoomIn 
$allocate = $this->getAll] 
SUnderCover= S$this->sel 
$sthis->saveWordInfo ($wor 











} 


Sthis->ou 





二 








LOCai 


ay 





$data->Content); 











Bay 


























10.2.6 ”加 入 房间 


任何 用 户 输入 大 于 1000 的 房间 ， 都 被 认为 是 党 试 加 入 一 个 房间 。 首 先 检查 该 房间 是 不 是 已 经 创建 好 。 如 果 房 间 已 建 好 ， 调 用 getWordlnfo 从 bg_user 获 取 房 间 相 关 信息 。 得 





党 


oByOpenid ($data->FromUserName); 

te (Sinfo['Count"]); 

ctUnderCover ($allocate[0], $info['Count"]); 
ds[0], 


$words[1], S$UnderCover, S$data-> FromUserName, 


$sthis->refreshRoom($info['roomid"']); 
$content=" 
词 成 功 !".S$this->detailInfo ($in 
tputText ($content) 


的 Id， 并 检查 该 1d 是 否 为 卧底 ， 如 果 是 分 配 word1， 否 则 分 配 word2。 


后 台 调 用 processChangeWord。 首 先 对 输入 的 消息 用 中 文 逗号 “，” 或 英文 逗号 “， 





$ini 


fo['Count"']); 


fo['roomid'], S$allocate[0], S$allocate[1], $words[0], $words[1], $UnderCover); 


”分 割 ， 如 果 两 种 分 割 都 得 不 到 两 个 词语 ， 则 表明 格式 有 问题 ， 需 要 重新 输 


到 的 curUserld 作 为 当前 玩家 








function joinl 


{ 





Room (Sroomid) 














$sstatus 
if($sta 
{ 

Sde 


$ids = explode(",", S$detail] 


= S$this->getSta 
tus == 'created') 
tail = S$this->getWordI 








tusByRoomid ($roomid); 








n 


fo($roomid); 








$allocate = $this->getAll] 





一 PP- 





$content = " 


房间 已 满 ， 请 选择 新 的 房间 加 入 "; 


Sthis->outputText ($content); 


房 


词 |i 





} 

















| ['underCoverId'] 
Locate ($detail['Count"']); 
f($detail['curUserId'] > $detail['Count'"]) 





Scontent = " 
号 ; ".S$Sroomid; 
Scontent .="\n\n 
语 :" Sdatail['word2"]? 
} 
else 
{ 
Scontent .="\n\n 
































Sthis->outputText ($content); 

















词语 :" .Sdetail['word1']; 
} 
Scontent .="NnNn 
你 是 :".S$qetail['curUserIdq'] .nm 
本 
Scontent .="NnNn 
配置 ， 卧底 " .Sallocate[0]." 
人 ,平民 ".$allocate[1]." 
人 ™; 
$content .="\n\n 
输 了 要 有 惩罚 哦 ， 回 复 0 
查看 大 冒险 惩罚 "; 
} 
else 
{ 
Scontent .=" 


房 


间 已 过 期 ， 请 法 


Sthis->outputText ($content); 


} 





官 重新 建 房 "; 








返回 房间 的 相关 信息 并 将 curUserld 加 1。 





{ 





function getWordInfo ($roomid) 





Smysal = new SaeMysal () ， 
"select * from bg user where roomid ='$roomid'"; 


$sql = 


$detail=$mysql->getline (S59q1); 
"Update bg user set curUserId = curUserI 





$sql = 

















$mysql->runSgl ($sql); 
if ($mysql->errno() 





一 


die ("] 





[= 0) 





If (array Search ($detail['curUserId'], $ids) 


) 7 





== false) 














d +1 where roomid ="'$roomid'™"; 





Error:".S$mysql->errmsg () ) ; 


smysql->closeDb (); 
return S$detail; 


10.2.7 ”后台 操作 


房间 数 有 限 ， 所 以 需要 定期 清理 过 期 的 被 占用 的 房间 号 。SAE 提 供 计 划 任 务 cron， 它 根据 配置 文件 约定 的 时 间 执 行 特定 的 任务 。 我 们 在 config.yaml 中 添加 如 下 字段 : 


cron: 
-description: refresh 
url: BoardGame/refresh 














schedule: every 1 hour 
timezone: Beijing 





URL 是 执行 的 文件 即 任务 ; schedule 是 调度 周期 ， 可 以 配置 ， 很 灵活 ; timezone 是 时 区 ， 比 如 每 天 0 点 执行 这 样 的 配置 ， 设 置 时 区 是 比较 有 意义 的 。 


我 们 的 refresh.php 文 件 内 容 如 下 : 





<?php 
/** 
大 


每 隔 1 
小 时 检查 房间 是 否 过 期 ， 如 果 房 间 超过 2 
ae 即 过 期 



































Smysal = new SaeMysal () ， 
$sql = " update bg rooms set Free = true where DATE SUB (NOW(),INTERVAL 2 HOUR) >CreatedqTime and Free = false " 
$mysql->runSqgl ($sql); 











if ($mysql->errno() != 0) 
{ 


} 
smysql->closeDb () ， 
?> 





die ("Error:".S$mysgql->errmsg () ) ， 


10.3 ”效果 展示 


游戏 效果 如 下 图 所 示 : 


乔 名 二 口 悟 中 国联 诵 写 下 午 5:29 


《 订阅 号 ” 微 信 公众 平台 





------- 开 始 提示 ---- 


如果 已 经 找 好 了 .人 玩 ， 请 
先 一 个 人 当 法 官 ， 回 复 1 创 
建 游戏 


! 


二 创建 谁 是 卧底 ,请 输入 
条 戏 人 数 (4~-13 之 间 ， 不 包 
括 法 官 哦 ) 








正 





司 |@ 3 0 


coo 中 国联 通 定 下 午 5:29 








建 房 成 功 ! 您 是 法 官 ， 请 让 
世上 TS 癌 1 御 [ 





PP 加 JJ 


1000] 进入 房间 。 

房 号 : 1000 

配 置 : 卧底 1 人 ， 平 民 4 
人 

四 底 司 胖子 





复 [ 换 ]， 换 一 组 词 

可 复 [ 改 ] 自己 出 是 
回复 [0], 查 看 大 冒险 惩罚 ! 
一 局 结束 后 ， 不 必 重建 





oo 中 国联 通 学 下 午 6:30 Di, 
= 人 


窒 了 要 有 怎 昼 哦 ， 回 复 0 碍 


看 大 冒险 逢 
六 








换 词 成 功 !| 您 是 法 电 ， 请 让 
参与 洲 戏 的 玩家 对 我 回复 [ 
1000] 进 入 房间 。 

房 号 : 1000 

配 置 : 卧底 1 入 ， 平 民 4 
人 

中 奔 词 : 元 沪 

平民 词 : 展 昭 

Eh 压 : 4 号 

回复 [ 换 ]， 换 一 组 词 ， 
回复 [ 改 ]， 目 己 出 题 ， 
回复 [0], 查 看 大 冒险 惩罚 !( 
一 局 结束 后 ， 不 必 重 建 房 
回复 [ 换 ] 直 接 换 司 ) 





OO 中 国联 通 全 下 于 5:32 


双 订阅 号 


短信 会 人 欢 平 台 测 ... 


请 输入 卧底 词 和 平民 词 ,如 


9 





状元 ， 冠 军 


咏 词 成功 ! 您 是 法 家 ， 请 让 
参与 洲 戏 的 玩家 对 我 回复 [ 
1000] 进 和 房间。 

二 : 1000 

本 置 : 卧底 1 人 ， 平 民 4 
人 

EE 压 词 : 
平民 词 : 





3 换 一 组 词 ， 
回复 [ 改 ]， 自 己 出 题 ， 


sscocc 中 国联 通 合 下 午 5:30 全 


《订阅 号。 微 信 公 众 平台 测 .… 





时 底 Lie 


Fi A Fi Fe 一 111 白 下 


是 受 [ 以 J]， 月 己 汗 蝇 ， 
回复 [0], 三 看 大 冒险 惩罚 ! 
一 局 结束 后 ， 不 必 重 建 羽 
， 回 复 [ 换 ] 直 接 换 司 ) 


1000 i 








房 号 : 1000 

词语 : 肥 肉 

你 是 :1 

配置 : 卧底 1 人 ， 平 民 4 人 


请 了 和 要 有 怎 罚 哦 ， 回 复 0 查 
看 大 目 | A TE | 


YE Fm he 





()) (ww) 十 


图 ES 
国 BE 
El | 


seeco 中 国联 通 守 下 午 5:45 人 @ 了 六 26% 





《< 订阅 号 


EV = 


清 输 的 同学 摇 山 子 选 择 


1. 唱 一 首 儿 歌 ， 不 得 少 于 
3 名 


2. 人 芷 朋友 圈 发 : 喜欢 我 ， 
就 赶快 对 我 表白 吧 ! 然后 
截图 发 到 群 里 





3. 唱 一 首 周 杰 伦 的 歌 ， 不 
得 少 于 3 名 


4. 有 照 张大 腿 照 
5. 跟 群 里 一 位 异性 说 : 蒜 


啦 。 


中 


本 








